KosmoKrator

communication

Google Contacts MCP Integration for LangGraph

Connect Google Contacts to LangGraph through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 7 read 0 write OAuth browser flow auth
Submit Google Contacts feedback View package source

Connect Google Contacts to LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Google Contacts MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "mcpServers": {
    "kosmokrator-google_contacts": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=google_contacts",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=google_contacts --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Google Contacts instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Google Contacts Tools Visible to LangGraph

LangGraph sees stable MCP tool names generated from the Google Contacts integration catalog.

MCP toolSource functionTypeDescription
integration__google_contacts__google_contacts_create google_contacts.google_contacts_create Read Create a new Google Contact with name, email, phone, company, title, address, and notes.
integration__google_contacts__google_contacts_delete google_contacts.google_contacts_delete Read Permanently delete a Google Contact by resource name.
integration__google_contacts__google_contacts_get google_contacts.google_contacts_get Read Get full details of a single Google Contact including notes, websites, and group memberships.
integration__google_contacts__google_contacts_list google_contacts.google_contacts_list Read List all Google Contacts sorted by first name with pagination.
integration__google_contacts__google_contacts_list_groups google_contacts.google_contacts_list_groups Read List all Google Contact groups/labels (e.g., Friends, Family, custom groups) with member counts.
integration__google_contacts__google_contacts_search_contacts google_contacts.google_contacts_search_contacts Read Fuzzy search Google Contacts by name, email, or phone. Matches partial strings (e.g., "john", "acme.com", "555"). Use this to look up contacts before sending emails with gmail_send.
integration__google_contacts__google_contacts_update google_contacts.google_contacts_update Read Update an existing Google Contact. Unspecified fields are preserved. Email, phone, and address are added alongside existing values; name, company, title, and notes are replaced.

Related Google Contacts Pages

Google Contacts CLIUse direct JSON commands instead of MCP discovery. Google Contacts MCPFull gateway reference and MCP tool names. KosmoKrator for LangGraphClient-level gateway setup.