Skip to content
MCP server

Google Chat MCP

Read Google Chat spaces and messages and post to them from your AI agent

Runs locallyStatus and history
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-mcp

Add 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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity