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

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 Chat MCP Server

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

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