Skip to main content
Glama
Google Chat MCP Server

Google Chat MCP Server

by DXMHXR

Google Chat MCP Server

MCP server for Google Chat using the internal Dynamite API — no Google Cloud Console required.

⚠️ Disclaimer: Uses an undocumented internal API reverse-engineered by EionRobb. It may break at any time if Google updates their protocol.


Setup

1. Export cookies from your browser

  1. Install the Cookie-Editor extension (Chrome / Firefox)

  2. Open chat.google.com and make sure you're logged in

  3. Click the Cookie-Editor icon → Export → Export as JSON

  4. Save the file (anywhere you like)

Cookies expire when you log out or after a long period of inactivity. Re-export them if you get a 401 error.


Related MCP server: Google Chat MCP Sever (Extendable to Teams,Slack.)

You don't need to clone the repo or install dependencies manually. uv runs the server straight from GitHub and resolves dependencies automatically.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "googlechat": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/RHMDHDYT/googlechat-mcp",
        "googlechat-mcp"
      ],
      "env": {
        "GCHAT_COOKIES": "/absolute/path/to/cookies.json"
      }
    }
  }
}

Restart Claude Desktop after editing the config.

Claude Code

claude mcp add googlechat \
  --env GCHAT_COOKIES=/absolute/path/to/cookies.json \
  -- uvx --from git+https://github.com/RHMDHDYT/googlechat-mcp googlechat-mcp

Verify:

claude mcp list
claude mcp get googlechat

Alternative: install from a local clone

If you'd rather run from source:

git clone https://github.com/RHMDHDYT/googlechat-mcp
cd googlechat-mcp
pip install mcp protobuf requests

Then point the config at server.py directly:

{
  "mcpServers": {
    "googlechat": {
      "command": "python",
      "args": ["/absolute/path/to/googlechat-mcp/server.py"],
      "env": {
        "GCHAT_COOKIES": "/absolute/path/to/cookies.json"
      }
    }
  }
}

If you drop cookies.json directly into the googlechat-mcp/ folder, the server reads it automatically and you can omit the GCHAT_COOKIES env var.


Tools

Tool

Description

list_spaces

List all DMs and spaces you're a member of

read_messages

Read messages + attachments/Drive/URLs from a DM or space

send_message

Send a new message to a DM or space

reply_message

Reply to an existing thread

list_space_files

List all files, Drive items, and URLs ever shared

create_dm

Open a DM with a user by email


Troubleshooting

Error

Solution

cookies.json not found

Set the GCHAT_COOKIES env var or place cookies.json in the server folder

401 Unauthorized

Cookies expired — re-export them from your browser

Incomplete cookies

Make sure you export from chat.google.com, not another Google domain

Proto decode error

Google may have updated the API — check EionRobb's repo for the latest schema


Credits

Protobuf schema: EionRobb/purple-googlechat

Available Tools

13 tools
add_reactionC

Add an emoji reaction to a message

Inputs: group_id (required), message_id (required), topic_id (required), emoji (required), +1 more.

create_dmA

Open or create a DM conversation with a user by their Google email

Inputs: email (required).

get_user_statusB

Get presence/status of one or more users (DND state, custom status)

Inputs: user_ids (required).

list_membersB

List members of a Google Chat space or DM

Inputs: group_id (required), is_dm, page_size.

list_space_filesB

List all files, Drive attachments, and shared URLs in a space or DM

Inputs: group_id (required), is_dm, page_size.

list_spacesB

List all DMs and spaces the user is a member of

Inputs: page_size.

mark_as_readC

Mark a space or DM as read

Inputs: group_id (required), is_dm.

read_messagesB

Read recent messages from a space or DM, including Drive files, attachments, and URLs

Inputs: group_id (required), is_dm, page_size.

remove_reactionA

Remove an emoji reaction from a message

Inputs: group_id (required), message_id (required), topic_id (required), emoji (required), +1 more.

reply_messageB

Reply to an existing thread in a space or DM

Inputs: group_id (required), topic_id (required), text (required), is_dm.

search_messagesB

Search messages in a space or DM by keyword

Inputs: group_id (required), query (required), is_dm, page_size.

send_messageA

Send a new message (starts a new thread) in a space or DM

Inputs: group_id (required), text (required), is_dm.

set_typingB

Set typing indicator in a space or DM

Inputs: group_id (required), is_typing (required), is_dm, topic_id.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a distinct action and resource (e.g., reactions, DM creation, presence, file listing), with no overlapping or confusing purposes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, making them predictable and easy to understand.

    Tool Count5/5

    13 tools is well-scoped for a chat server, covering core messaging, reactions, searches, file handling, and presence without being excessive.

    Completeness4/5

    Missing edit/delete message and space management features, but the essential chat workflows are fully covered.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      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.
      27
      Python
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      This MCP server provides comprehensive Google Workspace integration (Gmail, Drive, etc.) with multi-user OAuth. Unique features include RAG-powered natural language to Chat card rendering, runtime Jinja2 macro creation, and dynamic tool management.
      7
      174 PyPI
      31
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Discord using personal user tokens instead of bot applications, allowing for seamless message management and server exploration. It provides tools for reading history, sending messages, and searching across channels and DMs directly through MCP-compatible clients.
      11
      MIT