Google Chat MCP Server
Provides tools for interacting with Google Chat, including listing spaces, reading messages, sending messages, replying to threads, listing files, and creating DMs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Chat MCP Server list my current spaces"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Open chat.google.com and make sure you're logged in
Click the Cookie-Editor icon → Export → Export as JSON
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.)
Recommended install (uvx, no clone needed)
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-mcpVerify:
claude mcp list
claude mcp get googlechatAlternative: 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 requestsThen 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 all DMs and spaces you're a member of |
| Read messages + attachments/Drive/URLs from a DM or space |
| Send a new message to a DM or space |
| Reply to an existing thread |
| List all files, Drive items, and URLs ever shared |
| Open a DM with a user by email |
Troubleshooting
Error | Solution |
| Set the |
| Cookies expired — re-export them from your browser |
| Make sure you export from |
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 toolsadd_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
Scored across 13 tools
Each tool targets a distinct action and resource (e.g., reactions, DM creation, presence, file listing), with no overlapping or confusing purposes.
All tool names follow a consistent verb_noun pattern in snake_case, making them predictable and easy to understand.
13 tools is well-scoped for a chat server, covering core messaging, reactions, searches, file handling, and presence without being excessive.
Missing edit/delete message and space management features, but the essential chat workflows are fully covered.
Maintenance
Related MCP Connectors
Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.
Your Gmail, Calendar, Drive, GitHub, Oura, wallet and confirmed profile facts in any MCP client.
Hosted WhatsApp MCP server: send and read messages from your own linked number. OAuth sign-in.
Use your Pronto feed, Spaces, Posts, Artifacts, and agents from any MCP client.
Related MCP Servers
- AlicenseCqualityCmaintenanceProvides MCP (Model Control Protocol) tools for accessing and interacting with Google Chat spaces and messages through OAuth2 authentication.525MIT
- AlicenseNot gradedqualityDmaintenanceGoogle 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.27PythonMIT
- AlicenseAqualityBmaintenanceThis 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.7174 PyPI31Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables 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.11MIT