google-workspace-mcp

Multi-Account-, token-effizienter MCP für Gmail + Kalender + Drive + Docs + Sheets. Entwickelt, weil der offizielle Claude-Connector nur ein Konto unterstützt und standardmäßig vollständige Nachrichten-/Dateiinhalte zurückgibt.

Warum es das gibt

• Multi-Account: OAuth für mehrere Postfächer (Arbeit + privat + Mitgründer). Jedes Tool akzeptiert eine account-E-Mail; Aliase werden über Send-As-Identitäten behandelt.

• Token-effizient: Suche/Liste liefert kompakte Formate ({id, from, subject, snippet, ...} für E-Mail, {id, name, mime, modified, size, ...} für Drive). Inhalte und Dateiinhalte sind optional.

• Keyring-basiert: Refresh-Tokens liegen im OS-Credential-Speicher — Keychain auf macOS, Credential Manager auf Windows, Secret Service auf Linux — nicht in Klartextdateien. Keine Tokens im Vault, keine Tokens in einem Repo.

• macOS, Windows und Linux: ein Installer pro Plattform, derselbe Connector.

Related MCP server: google-workspace-mcp

Tools (v2, 63 Tools)

Kontoverwaltung (3)

• gws_account_add — Browser-OAuth-Flow, fügt ein neues autorisiertes Postfach hinzu

• gws_account_list — autorisierte Konten + Standardkonto auflisten

• gws_account_remove — lokale Anmeldedaten entfernen (widerruft nicht Google-seitig)

Gmail (12)

• gmail_search — Suche mit Gmail-Operatoren. Kompakte Antwort.

• gmail_read — eine Nachricht oder einen vollständigen Thread lesen. Inhalte optional.

• gmail_send — E-Mail senden, optional from_alias für Send-As-Identitäten

• gmail_draft — Entwurf erstellen

• gmail_reply — antworten (erhält Thread + Header), optional reply_all

• gmail_labels_list — alle Labels auflisten

• gmail_label_apply — Labels stapelweise hinzufügen/entfernen

• gmail_archive — stapelweise archivieren (INBOX entfernen)

• gmail_trash — stapelweise in den Papierkorb verschieben

• gmail_sendas_list — Send-As-Identitäten dieses Postfachs auflisten

• gmail_attachments_list — Anhänge einer Nachricht auflisten (Dateiname, MIME-Typ, Größe)

• gmail_attachment_save — einen Anhang in eine lokale Datei herunterladen, Pfad wird zum direkten Lesen zurückgegeben

Kalender (7)

• cal_list_calendars — alle Kalender auflisten

• cal_list_events — kommende Ereignisse auflisten (standardmäßig kompakt, verbose=True für vollständig)

• cal_create_event — Ereignis erstellen, optional Google-Meet-Link

• cal_update_event — Felder teilweise aktualisieren

• cal_delete_event — löschen

• cal_freebusy — belegte Zeitfenster für die Terminplanung prüfen

• cal_respond — annehmen/ablehnen/vorläufig

Drive (18)

• drive_search — Freitext oder rohe Drive-q-Syntax. Nur Metadaten in der Antwort.

• drive_read_file — standardmäßig Metadaten; include_content=True für Inhalt

• drive_list_folder — direkte Kinder eines Ordners ('root' für Mein Drive)

• drive_create_folder — Ordner unter einem optionalen übergeordneten Ordner erstellen

• drive_upload — lokale Datei hochladen, optional convert_to_google

• drive_move — übergeordneten Ordner ändern

• drive_rename — Datei oder Ordner umbenennen

• drive_share — Lese-/Kommentar-/Schreibzugriff usw. per E-Mail gewähren

• drive_trash — weiches Löschen (wiederherstellbar)

• drive_untrash — aus dem Papierkorb wiederherstellen

• drive_permission_list — alle mit Zugriff auf eine Datei auflisten

• drive_permission_update — Rolle eines Berechtigten ändern

• drive_permission_delete — Berechtigung widerrufen

• drive_shared_drives_list — freigegebene Laufwerke auflisten, auf die dieses Konto zugreift

• drive_comments_list — Kommentare zu einer beliebigen Drive-Datei auflisten (Doc/Sheet/Slide/Upload)

• drive_comment_add — Kommentar hinzufügen, optional mit Anker

• drive_comment_reply — auf einen Kommentar antworten

• drive_comment_resolve — Kommentar als gelöst markieren

Docs (9)

• docs_create — neues Dokument, optional mit Anfangstext und übergeordnetem Ordner

• docs_read — standardmäßig Fließtext; structured=True für den vollständigen Docs-API-Baum

• docs_append — Text am Ende des Dokuments anhängen

• docs_insert_at — Text an einem bestimmten Index einfügen

• docs_replace_text — Suchen-und-Ersetzen, gibt Anzahl der Ersetzungen zurück

• docs_export — als Markdown / PDF / DOCX / RTF / Klartext exportieren

• docs_suggestions_list — ausstehende Vorschläge für Änderungsverfolgung auflisten

• docs_suggestions_accept_all — alle Vorschläge annehmen (Dokument wird neu geschrieben)

• docs_suggestions_reject_all — alle Vorschläge ablehnen (Dokument wird neu geschrieben)

Sheets (14)

• sheets_create — neue Arbeitsmappe, optional mit übergeordnetem Ordner

• sheets_list_sheets — Registerkarten mit Zeilen-/Spaltendimensionen auflisten

• sheets_add_sheet — neue Registerkarte zu einer vorhandenen Arbeitsmappe hinzufügen

• sheets_read_range — A1-Bereich lesen. Optionen FORMULA / UNFORMATTED_VALUE.

• sheets_write_range — Bereich überschreiben. USER_ENTERED parst Formeln.

• sheets_append — Zeilen unter vorhandenen Daten anhängen

• sheets_clear_range — Werte löschen (Formatierung bleibt erhalten)

• sheets_batch_read — mehrere Bereiche in einem API-Aufruf lesen

• sheets_batch_write — mehrere Bereiche in einem API-Aufruf schreiben

• sheets_named_ranges_list — benannte Bereiche in einer Arbeitsmappe auflisten

• sheets_named_range_add — benannten Bereich erstellen

• sheets_named_range_delete — benannten Bereich löschen

• sheets_conditional_format_add — Regel für bedingte Formatierung hinzufügen

• sheets_data_validation_add — Dropdown-/Zahlen-/E-Mail-/URL-Validierung festlegen

Installation

Schnellster Weg — ein Skript, keine manuelle Verdrahtung.

macOS und Linux:

git clone https://github.com/adelaidasofia/google-workspace-mcp.git
bash google-workspace-mcp/install.sh

Windows (PowerShell):

git clone https://github.com/adelaidasofia/google-workspace-mcp.git
powershell -ExecutionPolicy Bypass -File .\google-workspace-mcp\install.ps1

Der Installer erstellt eine isolierte venv, installiert Abhängigkeiten, nimmt Ihren Google-OAuth-Client (entweder interaktiv oder über GWS_CLIENT_ID / GWS_CLIENT_SECRET in der Umgebung) und registriert den Server bei Claude Code. Kann bedenkenlos erneut ausgeführt werden. Sie benötigen zuerst einen Google-OAuth-Client — siehe SETUP.md für das einmalige GCP-Setup (~45 Min.). Führen Sie dann gws_account_add aus Claude Code aus, um Ihr erstes Postfach zu autorisieren.

Beide benötigen Python 3.10 oder neuer und finden eine bereits vorhandene Installation.

• macOS / Linux versuchen zuerst python3, dann python3.14 bis python3.10, sodass ein Homebrew-Python auch zählt, wenn python3 auf das ältere System-Python von macOS verweist.

• Windows versucht zuerst py -3 (den Python-Launcher), dann python, python3 und die versionierten Namen. Jeder Kandidat muss laufen und seine eigene Version melden, bevor er zählt — das verhindert, dass der Microsoft-Store-Platzhalter in %LOCALAPPDATA%\Microsoft\WindowsApps ausgewählt wird: Es ist eine echte python.exe auf PATH, die nur den Store öffnet.

Falls Ihre Installation an einem Ort liegt, den keine Suche erraten würde (pyenv, conda, ein privates Präfix), benennen Sie sie:

GWS_PYTHON=/full/path/to/python3 bash google-workspace-mcp/install.sh

$env:GWS_PYTHON = 'C:\full\path\to\python.exe'
powershell -ExecutionPolicy Bypass -File .\google-workspace-mcp\install.ps1

-ExecutionPolicy Bypass steht absichtlich im Befehl. Windows blockiert heruntergeladene Skripte standardmäßig; dies wendet die Ausnahme nur auf diesen einen Lauf an, ohne die Richtlinie des Systems zu ändern.

Führen Sie es aus PowerShell aus, nicht aus Git Bash. install.sh erkennt Git Bash / MSYS und stoppt dort mit einem Hinweis auf install.ps1, anstatt einen POSIX-venv-Pfad zu registrieren, den ein natives Claude Code nicht starten kann. WSL ist echtes Linux und verwendet weiterhin install.sh.

Zeitzone. Der Connector liest die IANA-Zone des Rechners, sodass „15 Uhr" in einem cal_*-Aufruf 15 Uhr an Ihrem Standort bedeutet. Windows benennt seine Zonen auf eigene Weise (SA Western Standard Time), daher läuft dies über tzlocal, das der Installer mitbringt. Setzen Sie GWS_TIME_ZONE=America/Bogota, um zu überschreiben.

Öffnen Sie Claude Code und fügen Sie ein:

/plugin marketplace add adelaidasofia/google-workspace-mcp
/plugin install google-workspace-mcp@google-workspace-mcp

Sie müssen weiterhin das einmalige GCP-Setup in SETUP.md abschließen (~45 Min. für v1, ~5 Min. inkrementell für v2 Drive/Docs/Sheets), damit der Server eine client_secret.json für OAuth hat. Führen Sie gws_account_add aus Claude Code aus, um Ihr erstes Postfach zu autorisieren.

Führen Sie auf Windows anschließend install.ps1 aus. Die .mcp.json des Plugins startet den Server mit python3, und ein Plugin-Manifest kann nicht sagen „außer auf Windows, verwende stattdessen dies". Auf Windows ist python3 entweder nicht vorhanden oder der Microsoft-Store-Platzhalter, sodass der Connector registriert, aber nie gestartet wird. install.ps1 registriert ihn erneut mit einem absoluten Interpreterpfad, der auf jeder Plattform eindeutig ist.

Siehe SETUP.md für das einmalige GCP-Setup (~45 Min. für v1, ~5 Min. inkrementell zur Aktivierung von Drive/Docs/Sheets für v2).

Nach dem Setup:

pip3 install --break-system-packages -r requirements.txt

Bei Claude Code registrieren

Fügen Sie zur .mcp.json Ihres Projekts hinzu (oder zu ~/.claude.json für globalen Zugriff):

"google-workspace": {
  "type": "stdio",
  "command": "python3",
  "args": ["/path/to/google-workspace-mcp/server.py"]
}

Geben Sie unter Windows den vollständigen Pfad zu einem echten Interpreter an, nicht nur einen bloßen Namen — python3 ist dort normalerweise der Microsoft-Store-Platzhalter, der sich auflösen lässt, aber nie Python ausführt:

"google-workspace": {
  "type": "stdio",
  "command": "C:\\Users\\you\\google-workspace-mcp\\.venv\\Scripts\\python.exe",
  "args": ["C:\\Users\\you\\google-workspace-mcp\\server.py"]
}

Upgrade von v1 → v2

v2 fügt Drive + Docs + Sheets-Berechtigungen hinzu. Jedes autorisierte Konto muss einmal neu OAuth-autorisieren, damit Google die neuen Berechtigungen gewährt. Siehe SETUP.md Schritt 6b.

Roadmap

• v3: Gmail-Filter, Abwesenheitsantwort, Push-Benachrichtigungen (Gmail Watch), Kalender-ACL/Delegation, Slides, Forms, Tasks

• v4: Batch-Anfragen über Dienste hinweg, Drive-Revisionen

Verwandte MCPs

Gleicher Autor, gleiches Architekturmuster (FastMCP, Entwurf+Bestätigung bei Schreibvorgängen, Vault-Auto-Export, MIT):

• slack-mcp — Multi-Workspace-Slack

• imessage-mcp — macOS-iMessage

• whatsapp-mcp — WhatsApp über whatsmeow

• apollo-mcp — Apollo.io-CRM + Sequenzen

• substack-mcp — Substack-Schreiben + Analysen

• luma-mcp — lu.ma-Ereignisse

• parse-mcp — markitdown / Docling / LlamaParse-Router

• rescuetime-mcp — RescueTime-Produktivitätsdaten

• graph-query-mcp — Vault-Wissensgraph-Abfragen

• graph-autotagger-mcp — Wikilink-Vorschläge aus dem Graphen

• investor-relations-mcp — Seed-Runde-Pipeline-Tracker

• vault-sync-mcp — bidirektionale Vault-Synchronisierung

Telemetrie

Dieses Plugin sendet beim ersten Laden in einer Claude-Code-Sitzung auf einem bestimmten Rechner ein einzelnes anonymes Installationssignal an myceliumai.co.

Was gesendet wird:

• Plugin-Name (z. B. slack-mcp)

• Plugin-Version (z. B. 0.1.0)

Was NICHT gesendet wird:

• Keine Benutzerkennungen, Namen, E-Mails, Tokens oder API-Schlüssel

• Keine Dateipfade, Nachrichteninhalte oder etwas aus Ihrer Arbeit

• Keine IP-Adresse wird nach der Deduplizierung gespeichert

Warum: Hilft dem Maintainer zu wissen, welche Plugins tatsächlich installiert werden, damit die Aufmerksamkeit den genutzten gilt.

Deaktivieren: Setzen Sie die Umgebungsvariable MYCELIUM_NO_PING=1, bevor Sie Claude Code starten. Der Hook überspringt den Netzwerkaufruf vollständig. Bereits angepingte Installationen hinterlassen eine Markierung unter ~/.mycelium/onboarded-<plugin> — löschen Sie sie, wenn Sie den Zustand zurücksetzen möchten.

Lizenz

MIT

Erstellt von Mycelium AI. Vollinstallation oder Teamversion unter diazroa.com.