KosmoKrator

communication

Google Chat MCP Integration for Claude Agent SDK

Connect Google Chat to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Manual OAuth token auth
Submit Google Chat feedback View package source

Connect Google Chat to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Google Chat MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

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

Run the Gateway Manually

kosmokrator mcp:serve --integration=google-chat --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Google Chat 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 Chat Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Google Chat integration catalog.

MCP toolSource functionTypeDescription
integration__google_chat__google_chat_list_spaces google-chat.google_chat_list_spaces Read List Google Chat spaces the authenticated user belongs to. Returns space names, display names, and types. Supports pagination with pageSize and pageToken.
integration__google_chat__google_chat_get_space google-chat.google_chat_get_space Read Get details about a specific Google Chat space. Returns the space name, display name, type, and other metadata.
integration__google_chat__google_chat_list_messages google-chat.google_chat_list_messages Read List messages in a Google Chat space. Returns message text, sender info, and creation timestamps. Supports pagination with pageSize and pageToken.
integration__google_chat__google_chat_get_message google-chat.google_chat_get_message Read Get a specific message from a Google Chat space. Returns the full message including text, cards, sender, and annotations.
integration__google_chat__google_chat_create_message google-chat.google_chat_create_message Write Send a message to a Google Chat space. Supports plain text and card-based rich messages (cardsV2). Either text or cardsV2 must be provided.
integration__google_chat__google_chat_list_memberships google-chat.google_chat_list_memberships Read List members (human users and bots) in a Google Chat space. Returns member names, display names, and roles. Supports pagination with pageSize and pageToken.
integration__google_chat__google_chat_get_current_user google-chat.google_chat_get_current_user Read Get the authenticated user's membership details in a Google Chat space. Returns the user's display name, role, and membership state.

Related Google Chat Pages

Google Chat CLIUse direct JSON commands instead of MCP discovery. Google Chat MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.