Google Chat MCP Server

An MCP server for managing Google Chat spaces and messages, integrating seamlessly with AI assistants using the Model Context Protocol.

Features

• List Spaces: List Google Chat spaces the user is a member of.
• Get Space: Retrieve details about a specific space.
• Create Message: Send messages to spaces (supports threading).
• List Messages: Retrieve message history from a space.
• Get Message: Get details about a specific message.
• Update Message: Edit existing messages.
• Delete Message: Remove messages.
• List Memberships: List members of a space.

Installation

Prerequisites

• Python 3.9 or higher.
• A Google Cloud Project with the Google Chat API enabled.
• OAuth2 credentials (Client ID and Client Secret).

Local Setup

1. Install dependencies:

   pip install -e .
   

2. Run the server:

   python main.py --access-token <TOKEN> --refresh-token <REFRESH_TOKEN> --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET>
   

Configuration

Add the following to your MCP host configuration (e.g., mcp-config.json):

{
  "mcpServers": {
    "barie-google-chat-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "/path/to/google_chat",
        "barie-google-chat-mcp",
        "--access-token",
        "YOUR_ACCESS_TOKEN",
        "--refresh-token",
        "YOUR_REFRESH_TOKEN",
        "--client-id",
        "YOUR_CLIENT_ID",
        "--client-secret",
        "YOUR_CLIENT_SECRET"
      ]
    }
  }
}

Tools

• list_spaces: List spaces.
• get_space: Get space details.
• create_message: Send a message.
• list_messages: List messages in a space.
• get_message: Get message details.
• update_message: Update a message.
• delete_message: Delete a message.
• list_memberships: List space members.

License

MIT