gworkspace-mcp

Model Context Protocol-Server für die Google Workspace-Automatisierung: Google Sheets, Apps Script, Drive, Docs, Gmail und Trigger. Erstellt mit FastMCP.

Entwickelt für die Verwendung mit Claude Code (oder jedem anderen MCP-kompatiblen Client), damit Sie Apps Script-Projekte bearbeiten, Tabellen manipulieren, E-Mails senden und Drive-Dateien direkt aus einem Gespräch heraus verwalten können.

Funktionen

• Apps Script (9 Tools) — Auflisten, Lesen, Aktualisieren, Erstellen, Bereitstellen und Ausführen von Apps Script-Projekten. Granulare Dateibearbeitungen, sodass Sie nicht ganze Skripte neu schreiben müssen.

• Sheets (10 Tools) — Lesen/Schreiben von Bereichen, Batch-Updates, Formatierung, Schutz, Formeln, Dashboards.

• Drive (4 Tools) — Auflisten, Suchen, Verschieben und Verwalten von Dateien.

• Docs (1 Tool) — Lesen/Bearbeiten von Google Docs.

• Gmail (3 Tools) — E-Mails verfassen und senden.

• Trigger (3 Tools) — Verwalten von zeitbasierten und ereignisbasierten Apps Script-Triggern.

• Connect (1 Tool) — Ein lokales Apps Script-Projekt mit einer Tabelle verknüpfen.

Anforderungen

• Python 3.10+

• Ein Google Cloud-Projekt mit den folgenden aktivierten APIs:

  • Google Sheets API

  • Google Drive API

  • Apps Script API

  • Google Docs API

  • Gmail API

  • Google Calendar API

• OAuth 2.0 Desktop-Anmeldeinformationen (client_secret.json)

Installation

git clone https://github.com/LeooNic/gworkspace-mcp.git
cd gworkspace-mcp
pip install -e .

Oder mit uv:

uv pip install -e .

Google Cloud-Einrichtung

1. Gehen Sie zu console.cloud.google.com und erstellen Sie ein Projekt.

2. Aktivieren Sie die oben aufgeführten APIs unter APIs & Dienste → Bibliothek.

3. Gehen Sie zu APIs & Dienste → OAuth-Zustimmungsbildschirm, konfigurieren Sie ihn als Extern und fügen Sie Ihr Google-Konto als Testbenutzer hinzu.

4. Gehen Sie zu APIs & Dienste → Anmeldedaten → Anmeldedaten erstellen → OAuth-Client-ID, wählen Sie Desktop-App und laden Sie das JSON herunter.

5. Stellen Sie dem Server die Anmeldedaten auf eine der folgenden Arten zur Verfügung:

   • Platzieren Sie das JSON unter ~/.secrets/gworkspace-mcp/client_secret.json, oder

   • Setzen Sie GOOGLE_CLIENT_SECRET_PATH=/vollständiger/pfad/zu/client_secret.json, oder

   • Setzen Sie GOOGLE_OAUTH_CLIENT_ID und GOOGLE_OAUTH_CLIENT_SECRET als Umgebungsvariablen.

Beim ersten Ausführen eines Tools öffnet sich ein Browserfenster für die OAuth-Zustimmung. Das resultierende Token wird unter ~/.secrets/gworkspace-mcp/token.json gespeichert und automatisch aktualisiert.

Registrierung bei Claude Code

Fügen Sie dies zu Ihrer Claude Code settings.json (oder ~/.claude.json) hinzu:

{
  "mcpServers": {
    "gworkspace": {
      "command": "gworkspace-mcp"
    }
  }
}

Wenn gworkspace-mcp nicht in Ihrem PATH enthalten ist, verwenden Sie den absoluten Pfad zu der ausführbaren Datei, die durch pip install -e . erstellt wurde (unter Windows normalerweise C:\Users\<Sie>\AppData\Local\Programs\Python\Python3XX\Scripts\gworkspace-mcp.exe).

Alternative Aufrufmethode ohne Installation des Einstiegspunkts:

{
  "mcpServers": {
    "gworkspace": {
      "command": "python",
      "args": ["-m", "gworkspace_mcp.server"]
    }
  }
}

OAuth-Scopes

Der Server fordert die folgenden Scopes an:

• spreadsheets, drive, documents, calendar

• script.projects, script.deployments, script.processes, script.metrics

• gmail.send, gmail.compose

• userinfo.email, userinfo.profile

Sicherheitshinweise

• Ihre client_secret.json und token.json sind persönlich — committen Sie diese niemals. Die .gitignore des Repos schließt sie bereits aus.

• Tokens befinden sich unter ~/.secrets/gworkspace-mcp/.

• Der Server läuft lokal; er stellt keinen Netzwerk-Endpunkt bereit.

Lizenz

MIT — siehe LICENSE.