Skip to content
MCP server

Google Chat MCP

Read, send and react to Google Chat messages and manage spaces as the signed-in user

Runs locallyActively maintainedStatus and history

The repository was last updated 14 days ago and is published under MIT.

Install
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
GitHub stars
0
Last commit
14 days ago
Language
TypeScript

Similar MCP servers

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.

Acting as you, the server sends messages under your name and only lets you edit or delete your own messages and reactions. Membership changes need you to be a space manager. A send is never retried after an ambiguous failure, so a flaky connection cannot post a duplicate to a real room.

There is no need to edit config files to authenticate: say "connect Google Chat" and the server walks through creating an OAuth client, catches Google's redirect on 127.0.0.1 with PKCE and stores the tokens itself. Scopes are whatever you grant, and read-only scopes are enough for browsing.

The README is open about limits. The Chat API cannot search message text, only filter by creation time and thread; find_direct_message never creates a DM; and file bytes are not uploaded or downloaded. Uncovered methods such as creating a space go through raw_request. Acting as a Chat app (cards, forced deletes) needs separate Google Cloud setup, bridged only by a service-account token.

Install

Run in a terminal

claude mcp add mcp-google-chat --env GOOGLE_CHAT_CLIENT_SECRET='<GOOGLE_CHAT_CLIENT_SECRET>' --env GOOGLE_CHAT_REFRESH_TOKEN='<GOOGLE_CHAT_REFRESH_TOKEN>' --env GOOGLE_CHAT_ACCESS_TOKEN='<GOOGLE_CHAT_ACCESS_TOKEN>' -- npx -y mcp-google-chat

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-google-chat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-chat"
      ],
      "env": {
        "GOOGLE_CHAT_CLIENT_SECRET": "<GOOGLE_CHAT_CLIENT_SECRET>",
        "GOOGLE_CHAT_REFRESH_TOKEN": "<GOOGLE_CHAT_REFRESH_TOKEN>",
        "GOOGLE_CHAT_ACCESS_TOKEN": "<GOOGLE_CHAT_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-google-chat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-chat"
      ],
      "env": {
        "GOOGLE_CHAT_CLIENT_SECRET": "<GOOGLE_CHAT_CLIENT_SECRET>",
        "GOOGLE_CHAT_REFRESH_TOKEN": "<GOOGLE_CHAT_REFRESH_TOKEN>",
        "GOOGLE_CHAT_ACCESS_TOKEN": "<GOOGLE_CHAT_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-google-chat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-chat"
      ],
      "env": {
        "GOOGLE_CHAT_CLIENT_SECRET": "<GOOGLE_CHAT_CLIENT_SECRET>",
        "GOOGLE_CHAT_REFRESH_TOKEN": "<GOOGLE_CHAT_REFRESH_TOKEN>",
        "GOOGLE_CHAT_ACCESS_TOKEN": "<GOOGLE_CHAT_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-google-chat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-chat"
      ],
      "env": {
        "GOOGLE_CHAT_CLIENT_SECRET": "<GOOGLE_CHAT_CLIENT_SECRET>",
        "GOOGLE_CHAT_REFRESH_TOKEN": "<GOOGLE_CHAT_REFRESH_TOKEN>",
        "GOOGLE_CHAT_ACCESS_TOKEN": "<GOOGLE_CHAT_ACCESS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-google-chat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-chat"
      ],
      "env": {
        "GOOGLE_CHAT_CLIENT_SECRET": "<GOOGLE_CHAT_CLIENT_SECRET>",
        "GOOGLE_CHAT_REFRESH_TOKEN": "<GOOGLE_CHAT_REFRESH_TOKEN>",
        "GOOGLE_CHAT_ACCESS_TOKEN": "<GOOGLE_CHAT_ACCESS_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GOOGLE_CHAT_CLIENT_IDGoogle OAuth2 client id (refresh-token flow).
  • GOOGLE_CHAT_CLIENT_SECRETGoogle OAuth2 client secret (refresh-token flow). Treat it as a secret.
  • GOOGLE_CHAT_REFRESH_TOKENGoogle OAuth2 refresh token, exchanged for access tokens automatically. Treat it as a secret.
  • GOOGLE_CHAT_ACCESS_TOKENStatic OAuth2 access token (~1h lifetime) — alternative to the refresh-token trio, e.g. a service-account (Chat app) token or for testing.
  • GOOGLE_CHAT_OAUTH_PORTFixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.
  • GOOGLE_CHAT_API_BASEAPI root override.
  • GOOGLE_CHAT_TIMEOUT_MSPer-request timeout in milliseconds.
  • GOOGLE_CHAT_MAX_RETRIESRetries on transient errors (429 always; 5xx/network for reads).

What it does

20 tools
Spaces, messages, threads, reactions, attachment metadata and memberships.
In-chat sign-in
OAuth with PKCE on a loopback port, with no restart or config editing.
Thread control
Reply to a thread by name or key, falling back to a new thread unless told to fail.
Safe sends
Writes are never replayed after an ambiguous failure.
raw_request escape hatch
Calls API methods the named tools do not cover.

Good for

  • Summarize what was decided in a team space today
  • Reply in a deploy thread that a rollout is finished
  • Add a colleague to a space as manager
  • List who reacted to an announcement

Pricing

Open source

Google Chat MCP FAQ

Can it search message text?

No. The Chat API only filters by creation time and thread.

Does it send as me or as a bot?

As the signed-in user. Chat-app behaviour needs a separate Google Cloud setup and a service-account token.

What do I need to run it?

Node.js 20 or newer and a Google account with Google Chat; install with npx -y mcp-google-chat@latest.

Can it upload files?

No. Attachment metadata can be read, but file bytes are not transferred.

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 mcp-google-chat --env GOOGLE_CHAT_CLIENT_SECRET='<GOOGLE_CHAT_CLIENT_SECRET>' --env GOOGLE_CHAT_REFRESH_TOKEN='<GOOGLE_CHAT_REFRESH_TOKEN>' --env GOOGLE_CHAT_ACCESS_TOKEN='<GOOGLE_CHAT_ACCESS_TOKEN>' -- npx -y mcp-google-chat

What are the best alternatives to Google Chat MCP?

The closest alternatives to Google Chat MCP are TrendRadar, Getmitra, Discord, Zoom and Email Spam Tester.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers