# Google Chat MCP

> Google Chat MCP is an open-source MCP server for communication. Read, send and react to Google Chat messages and manage spaces as the signed-in user. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI
- **Repository:** https://github.com/a1-x-tech/mcp-google-chat
- **GitHub stars:** 0
- **License:** MIT
- **MCP Registry name:** io.github.A1-x-Tech/mcp-google-chat
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.
- [Slack_connect](https://ai-powered.com/mcp/slack-connect): Slack_connect is a freemium MCP server for communication.
- [Postmark](https://ai-powered.com/mcp/postmark): Postmark is a freemium MCP server for communication.
- [Gmail](https://ai-powered.com/mcp/gmail-5): Gmail is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/google-chat-mcp-2
