home / mcp / google chat mcp server

Google Chat MCP Server

Google Chat MCP server that lets AI assistants like Claude and Cursor participate directly in team conversations - search messages, help teammates, share files, and coordinate across chat platforms.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "siva010928-multi-chat-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "src.server",
        "--provider",
        "google_chat",
        "-local-auth"
      ]
    }
  }
}

You can run a single AI-powered MCP server that connects your AI assistant to multiple chat platforms, including Google Chat, while keeping conversations and data under your organization’s control. This server provides a unified interface to interact with team chats across providers, enabling cross-platform collaboration and context-aware assistance from your AI.

How to use

You use the MCP server by starting a local, multi-provider agent that talks to Google Chat and optionally other chat platforms at the same time. The Google Chat provider is production-ready and can operate alongside other providers through a unified interface. To begin, authenticate with Google Chat, then run the MCP server so your AI assistant can send, search, summarize, and attach content across your configured chat spaces. You can issue prompts that target multiple spaces or platforms in one go, and the AI will perform actions in each provider as needed.

How to install

Prerequisites you need before installing:

- Python 3.9+

- UV Package Manager (recommended)

- Google Cloud Project with Google Chat API enabled

- MCP Client (Claude Desktop, Cursor, or other MCP-compatible AI assistant)

Follow these steps to install and set up the server locally.

Additional sections

Configuration and runtime notes: The Google Chat MCP support is designed for local or on-premises deployments to maximize security and data privacy. You prepare a Google Cloud project, enable the Google Chat API, and complete the configuration in the Google Cloud Console (app name, logo, etc.). You then download credentials.json to the Google Chat provider directory before starting the server with local authentication.

Running multiple providers: You can run the Google Chat provider together with additional providers such as Slack or Teams. Each provider runs in its own server instance, yet all share a unified interface so your AI assistant can operate across platforms in parallel. This enables workflows like incident response, knowledge consolidation, and cross-platform team coordination.

Troubleshooting tips: Ensure Google Chat API scopes are granted, credentials.json is in the correct location, and network connectivity allows access to Google services. If authentication fails, re-run the local authentication step to refresh credentials.

Security and usage policies: Keep sensitive conversations within your organization. Use on-premises LLMs or locally hosted agents to maintain control over data and access policies. Implement organization-specific security measures and monitor data flows to meet compliance requirements.

Available tools

get_chat_spaces_tool

List Google Chat spaces the AI can access.

manage_space_members_tool

Add or remove members from a Google Chat space.

get_conversation_participants_tool

Retrieve participants in a chat conversation.

summarize_conversation_tool

Provide a concise summary of a conversation.

send_message_tool

Send a message to a chat space or thread.

reply_to_message_thread_tool

Reply within a specific message thread.

update_chat_message_tool

Update an existing chat message.

delete_chat_message_tool

Delete a chat message.

add_emoji_reaction_tool

React to a message with an emoji.

get_chat_message_tool

Fetch details about a specific chat message.

search_messages_tool

Search messages across spaces.

get_my_mentions_tool

Find messages where you were mentioned.

get_my_user_info_tool

Retrieve your user profile information.

get_user_info_by_id_tool

Fetch information about a user by ID.

get_message_with_sender_info_tool

Get a message with sender details.

list_messages_with_sender_info_tool

List messages with sender details.

upload_attachment_tool

Upload an attachment to a chat.

send_file_message_tool

Send a file’s content as a message.

send_file_content_tool

Share formatted file content in a message.

batch_send_messages_tool

Send multiple messages in a single operation.