nguyenvanduocit/google-chat-mcp

Google Chat MCP

A Model Context Protocol (MCP) server for Google Chat, enabling AI assistants to interact with Google Chat spaces, messages, and members.

Features

• Spaces: List and get details of Google Chat spaces
• Messages: List, get, send, and delete messages
• Members: List and get members of spaces
• Attachments: Upload file attachments to messages

Prerequisites

1. A Google Cloud project with the Google Chat API enabled
2. OAuth 2.0 Client ID credentials (Desktop app type)

Setup

1. Create OAuth 2.0 Credentials

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Google Chat API
4. Go to APIs & Services > Credentials
5. Click Create Credentials > OAuth client ID
6. Select Desktop app as the application type
7. Download the JSON file and save it as google-credentials.json

2. Generate OAuth Token

Use the included token generation tool:

# Build the token generator
go build -o get-google-token ./scripts/get-google-token

# Run it with your credentials file
./get-google-token \
  -credentials /path/to/google-credentials.json \
  -token /path/to/google-token.json

This will:

1. Open your browser for Google authentication
2. Ask you to authorize the required Chat API scopes
3. Save the OAuth token to the specified path

3. Set Environment Variables

export GOOGLE_CREDENTIALS_FILE=/path/to/google-credentials.json
export GOOGLE_TOKEN_FILE=/path/to/google-token.json

Or create a .env file:

GOOGLE_CREDENTIALS_FILE=/path/to/google-credentials.json
GOOGLE_TOKEN_FILE=/path/to/google-token.json

Usage

Install

go install github.com/nguyenvanduocit/google-chat-mcp@latest

Build from source

go build -o google-chat-mcp .

Run (STDIO mode)

./google-chat-mcp --env .env

Run (HTTP mode)

./google-chat-mcp --env .env --http_port 3003

MCP Configuration

Add to your MCP settings:

STDIO mode

{
  "mcpServers": {
    "google-chat": {
      "command": "/path/to/google-chat-mcp",
      "args": ["--env", "/path/to/.env"]
    }
  }
}

HTTP mode

{
  "mcpServers": {
    "google-chat": {
      "url": "http://localhost:3003/mcp"
    }
  }
}

Available Tools

Spaces

• google_chat_list_spaces - List all accessible Google Chat spaces
• google_chat_get_space - Get details of a specific space

Messages

• google_chat_list_messages - List messages in a space
• google_chat_get_message - Get a specific message
• google_chat_send_message - Send a message to a space
• google_chat_delete_message - Delete a message
• google_chat_upload_attachment - Upload a file attachment to a space

Members

• google_chat_list_members - List members of a space
• google_chat_get_member - Get details of a specific member

License

MIT