Skip to main content
Glama

google-chat-mcp

MCP-Server für Google Chat. Ermöglicht Claude (Code / Desktop) oder einem beliebigen MCP-Client, deine Spaces aufzulisten, Nachrichten zu lesen und zu durchsuchen, Threads und Mitglieder abzurufen und – optional – Nachrichten in deinem Namen zu senden.

Standardmäßig schreibgeschützt. Läuft lokal über stdio. Das Refresh-Token wird mit 0600 unter ~/.google-chat-mcp/ gespeichert.

Werkzeuge

Werkzeug

Eingabe

Hinweise

list_spaces

type (all/space/group/dm), query, resolveDmNames, limit

Nach letzter Aktivität sortiert. DMs haben keinen Namen, außer wenn resolveDmNames verwendet wird (begrenzt auf 40 Abfragen).

list_messages

space, since, until, limit ≤100, pageToken

Neueste zuerst. since/until werden serverseitig gefiltert.

search_messages

query (Teilstring oder /regex/), spaces?, since, until, limit

Clientseitiger Scan; die Chat-API hat keine Volltextsuche. Standardfenster 14 Tage, ≤500 Nachrichten/Space.

get_thread

thread

Alle Antworten, älteste zuerst.

list_members

space

Benutzer + Rollen, Namen/E-Mails über die People API.

send_message

space, text, thread?

Nur registriert, wenn SEND_ENABLED=true.

Absendernamen stammen aus dem People-API-Verzeichnis (directory.readonly). Wenn diese API deaktiviert ist oder der Benutzer extern ist, erhältst du stattdessen users/<id> — alles andere funktioniert weiterhin.

Related MCP server: google-mcp

Einrichtung

Erfordert ein Google Workspace-Konto. Private @gmail.com-Konten können die Chat-API nicht aufrufen (403).

1. Google Cloud-Projekt (einmalig, ~10 Min.)

  1. console.cloud.google.com → Projekt erstellen/auswählen.

  2. APIs & Dienste → Bibliothek → Google Chat API und People API aktivieren.

  3. Tab Google Chat API → Konfiguration → App-Name, Avatar-URL, Beschreibung ausfüllen; interaktive Funktionen aus; Sichtbarkeit für deine Domain. Speichern.

    Achtung: Die Chat-API lehnt alle OAuth-Aufrufe mit 403 ab, bis dieses Formular gespeichert ist, sogar für schreibgeschützte Benutzerauthentifizierung.

  4. OAuth-Zustimmungsbildschirm → Intern → Bereiche hinzufügen:

    • https://www.googleapis.com/auth/chat.spaces.readonly

    • https://www.googleapis.com/auth/chat.messages.readonly

    • https://www.googleapis.com/auth/chat.memberships.readonly

    • https://www.googleapis.com/auth/directory.readonly

    • https://www.googleapis.com/auth/chat.messages.create (nur wenn du send_message möchtest)

  5. Anmeldedaten → Anmeldedaten erstellen → OAuth-Client-ID → Desktop-App → JSON herunterladen. Halte es aus jedem Repository heraus.

2. Anmelden

export GOOGLE_CHAT_CLIENT_SECRET_PATH=/path/to/client_secret.json
npx google-chat-mcp login        # browser opens → sign in with your Workspace account
npx google-chat-mcp whoami       # sanity check

3. Bei Claude Code registrieren

claude mcp add google-chat \
  -e GOOGLE_CHAT_CLIENT_SECRET_PATH=/path/to/client_secret.json \
  -- npx -y google-chat-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "google-chat": {
      "command": "npx",
      "args": ["-y", "google-chat-mcp"],
      "env": { "GOOGLE_CHAT_CLIENT_SECRET_PATH": "/path/to/client_secret.json" }
    }
  }
}

Umgebung

Variable

Standardwert

Zweck

GOOGLE_CHAT_CLIENT_SECRET_PATH

—

Desktop-OAuth-Client-JSON. Auf macOS wird auf den Keychain-Eintrag jay-google-oauth/client zurückgegriffen.

GOOGLE_CHAT_TOKEN_PATH

~/.google-chat-mcp/token.json

Refresh-Token-Cache.

SEND_ENABLED

false

true registriert send_message und fordert den create-Bereich an. Führe login nach der Änderung erneut aus.

Hinweise zum Kontingent

Chat-API: ~60 Anfragen/min/Benutzer. Space- und Mitgliederlisten werden prozessintern 5 Minuten lang zwischengespeichert; aufgelöste Benutzernamen werden auf der Festplatte in ~/.google-chat-mcp/users.json zwischengespeichert. search_messages ist die teure Operation — grenze sie mit spaces und since ein.

Entwicklung

pnpm install
pnpm dev login
pnpm typecheck && pnpm lint && pnpm build

Node ≥ 22. TypeScript strict, ESM, Build mit tsup.

Lizenz

MIT

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Google Chat through MCP, allowing listing spaces and messages, searching messages, and sending messages. Supports local and remote transports.
      Apache 2.0
    • -
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to read and send messages in Google Chat spaces using service account authentication.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to work in Google Chat through natural language: find spaces and direct messages, read and send messages, manage threads, reactions, attachments, and memberships while acting as the signed-in user.
      20
      140 npm
      MIT