# Google Chat MCP

> Google Chat MCP is an open-source MCP server for communication. Read Google Chat spaces and messages and post to them from your AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** vscode, CLI, self-hosted
- **Website:** https://renzojohnson.com/contributions/google-chat-mcp
- **MCP Registry name:** com.renzojohnson/google-chat-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

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