Google Chat MCP
Read Google Chat spaces and messages and post to them from your AI agent
- Pricing
- Open source
- Platforms
- vscode, CLI, self-hosted
- Runs
- Locally
- Version
- 26.11.14
- Listing updated
- 2 days ago
About Google Chat MCP
Google Chat MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
This is an independent local server for people on Google Workspace. Read access is split across five tools: list spaces, get a space, list messages, get a message and list members. Writes go through a single chat_admin tool that sends, edits and deletes messages and creates spaces, and delete only runs when the agent passes confirm: true.
It works on your own machine with your own Google credentials: an OAuth client, a service-account key or gcloud Application Default Credentials. A VS Code extension offers a setup wizard and registers the server with eight agents, or you can run the npm package with Node.js 22 or newer.
Limits are practical: the Chat API is for Workspace accounts rather than personal Gmail, only spaces your account belongs to are visible, and attachment contents are not read. The author notes it is not Google's own Chat MCP server.
Install
Run in a terminal
claude mcp add google-chat-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-chat-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"google-chat-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-chat-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"google-chat-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-chat-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"google-chat-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-chat-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"google-chat-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-chat-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"google-chat-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-chat-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
"GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
}
}
}
}Configuration
GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Google Chat scopes.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- chat_list_spaces
- List spaces, group chats and direct messages you belong to.
- chat_get_space
- Get the details of one space.
- chat_list_messages
- List messages in a space with time filter and order.
- chat_get_message
- Get one message.
- chat_list_members
- List members of a space.
- chat_admin
- Send, update and delete messages and create spaces.
What it does
- Space and DM listing
- Lists spaces, group chats and direct messages you belong to.
- Message history
- Reads up to 1,000 messages with time filters and order.
- Member lists
- Shows who is in a space.
- Admin actions
- Send, edit and delete messages and create spaces.
- Confirmation on delete
- delete_message does nothing without confirm: true.
- Eight agents
- Registers with Copilot, Claude Code, Cursor, Codex, Gemini, Windsurf, Continue and Cline.
Good for
- Catch up on a space after time away
- Find a message that holds a requirement
- Build an incident timeline from chat
- Post release notes to a space
- See who is in the support space
Pricing
Open source
Free, MIT-licensed
Prices change. Check renzojohnson.com before you buy.
Google Chat MCP FAQ
Does it work with personal Gmail?
No, Google's Chat API is for Workspace accounts.
Is it free?
Yes, the extension is free and MIT-licensed.
Where does data go?
Only to Google; the server runs locally with no telemetry.
Can it read attachments?
It lists attachments but does not read their contents.
Is Google Chat MCP free?
Yes. Google Chat MCP is open source, so you can use and self-host it for free.
How do I add Google Chat MCP to Claude Code?
Run this command in your terminal: claude mcp add google-chat-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-chat-mcp
What are the best alternatives to Google Chat MCP?
The closest alternatives to Google Chat MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Google Chat MCP

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity