Skip to main content
Glama
Google Chat MCP Server

Google Chat MCP Server

by hungvudang

google-chat-mcp

Post to Google Chat from any MCP client through incoming webhooks.

Requires Node.js 22.18 or later.

Setup

  1. In Google Chat, open the space and go to Apps & integrations > Webhooks > Add webhook. Copy the URL. Anyone with this URL can post to the space, so keep it private.

  2. Add the server to your MCP client's config:

    {
      "mcpServers": {
        "google-chat": {
          "command": "npx",
          "args": ["-y", "@hungvudang/google-chat-mcp"],
          "env": {
            "GOOGLE_CHAT_WEBHOOK": "https://chat.googleapis.com/v1/spaces/..."
          }
        }
      }
    }

    To post to several spaces, add one GOOGLE_CHAT_WEBHOOK_<NAME> per space to env, for example GOOGLE_CHAT_WEBHOOK_ALERTS.

    Some clients add servers from the command line instead. With Claude Code, for example:

    claude mcp add google-chat \
      -e GOOGLE_CHAT_WEBHOOK=https://chat.googleapis.com/v1/spaces/... \
      -- npx -y @hungvudang/google-chat-mcp

Related MCP server: Google Chat MCP Server

Configuration

Variable

Description

GOOGLE_CHAT_WEBHOOK

Webhook of the default space

GOOGLE_CHAT_WEBHOOK_<NAME>

Webhook of another space. GOOGLE_CHAT_WEBHOOK_DEV_TEAM adds a space called dev-team

GOOGLE_CHAT_DEFAULT_SPACE

Space to use when none is named. Defaults to default, or to the only space if there is just one

GOOGLE_CHAT_TIMEOUT_MS

How long to wait for Google Chat. Default 10000

LOG_LEVEL

trace, debug, info, warn, error or fatal. Default info

At least one webhook is required.

Usage

Ask your assistant to post something, for example "tell the alerts space that the deploy is done".

Tool

What it does

send

Sends a message to a space, optionally as a reply in a thread

report

Sends a card with a title, text, labelled details and link buttons

preview

Shows how a message will look, without sending it

The assistant writes in Markdown and the server converts it to Google Chat formatting. The server also gives the assistant a short writing guide so messages read like a teammate wrote them.

Development

npm install
npm test
npm run build
cp env/.env.local .env   # then fill in a webhook
node --env-file=.env build/index.js

License

MIT

Available Tools

3 tools
previewPreview a messageA
Read-only

Show exactly how a message will look in Google Chat before sending it with send. Read google-chat://guide for tone and formatting.

Inputs: text (required), format. Returns: text

reportSend a reportA

Send a structured report to a Google Chat space: a title, optional plain text, labelled details and link buttons. Read google-chat://guide first.

Inputs: title (required), text, links, space, +3 more. Returns: name, thread

sendSend a messageA

Send a text message to a Google Chat space, optionally as a reply in a thread. Read google-chat://guide first.

Inputs: text (required), space, format, threadKey. Returns: name, thread

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 3 tools

    Disambiguation4/5

    send and report both deliver content to a space, but report is clearly specialized for structured output and preview is explicitly non-sending. An agent can distinguish them, though send/report selection may require knowing whether structured report format is desired.

    Naming Consistency5/5

    All three tools use short, consistent imperative-style verb names: send, report, preview. There is no mixing of casing or naming conventions.

    Tool Count5/5

    Three tools are well-scoped for a focused outbound-messaging server: one general send, one structured report, and one preview aid. Each has a clear role and the set does not feel bloated.

    Completeness3/5

    The surface covers sending and previewing messages but lacks obvious Google Chat operations such as listing spaces, reading messages, or updating/deleting sent messages. These gaps may force agents to rely on external context to identify spaces and verify results.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers