google-workspace-mcp

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

Warum gibt es das?

• Multi-Account: OAuth für mehrere Postfächer (beruflich + privat + Mitgründer). Jedes Tool benötigt eine account-E-Mail-Adresse; Aliase werden über Send-As-Identitäten gehandhabt.

• Token-effizient: Suchen/Auflisten liefert kompakte Formate zurück ({id, from, subject, snippet, ...} für E-Mails, {id, name, mime, modified, size, ...} für Drive). Nachrichtentexte und Dateiinhalte sind optional.

• Keychain-gestützt: Refresh-Token werden im macOS-Schlüsselbund gespeichert, nicht in Klartextdateien. Keine Token im Vault, keine Token in irgendeinem Repository.

Tools (v2, 61 Tools)

Kontoverwaltung (3)

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

• gws_account_list — listet autorisierte Konten + Standardkonto auf

• gws_account_remove — entfernt lokale Anmeldedaten (widerruft diese nicht auf Google-Seite)

Gmail (10)

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

• gmail_read — liest eine Nachricht oder einen vollständigen Thread. Nachrichtentexte sind optional.

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

• gmail_draft — Entwurf erstellen

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

• gmail_labels_list — alle Labels auflisten

• gmail_label_apply — Labels stapelweise hinzufügen/entfernen

• gmail_archive — stapelweise archivieren (aus POSTEINGANG entfernen)

• gmail_trash — stapelweise in den Papierkorb verschieben

• gmail_sendas_list — Send-As-Identitäten für dieses Postfach auflisten

Kalender (7)

• cal_list_calendars — alle Kalender auflisten

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

• cal_create_event — Termin erstellen, optional mit Google Meet-Link

• cal_update_event — Felder teilweise aktualisieren

• cal_delete_event — löschen

• cal_freebusy — Verfügbarkeit für die Terminplanung prüfen

• cal_respond — annehmen/ablehnen/mit Vorbehalt

Drive (18)

• drive_search — Freitext- oder rohe Drive-q-Syntax. Antwort enthält nur Metadaten.

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

• drive_list_folder — direkte Unterelemente eines Ordners ('root' für Meine Ablage)

• drive_create_folder — Ordner unter einem optionalen übergeordneten Element erstellen

• drive_upload — lokale Datei hochladen, optional convert_to_google

• drive_move — übergeordneten Ordner ändern

• drive_rename — Datei oder Ordner umbenennen

• drive_share — Zugriff per E-Mail gewähren (Leser/Kommentator/Bearbeiter/etc.)

• drive_trash — in den Papierkorb verschieben (wiederherstellbar)

• drive_untrash — aus dem Papierkorb wiederherstellen

• drive_permission_list — alle Personen 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 erledigt markieren

Docs (9)

• docs_create — neues Dokument, optional mit anfänglichem Text 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 einer bestimmten Position einfügen

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

• docs_export — exportieren als Markdown / PDF / Docx / Rtf / Plain

• docs_suggestions_list — ausstehende Änderungsvorschläge auflisten

• docs_suggestions_accept_all — alle Vorschläge akzeptieren (schreibt das Dokument um)

• docs_suggestions_reject_all — alle Vorschläge ablehnen (schreibt das Dokument um)

Tabellen (14)

• sheets_create — neue Arbeitsmappe, optional mit übergeordnetem Ordner

• sheets_list_sheets — Tabellenblätter mit Zeilen-/Spaltenabmessungen auflisten

• sheets_add_sheet — neues Tabellenblatt zu einer bestehenden Arbeitsmappe hinzufügen

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

• sheets_write_range — Bereich überschreiben. USER_ENTERED parst Formeln.

• sheets_append — Zeilen unter bestehenden Daten anhängen

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

• sheets_batch_read — Lesen mehrerer Bereiche in einem API-Aufruf

• sheets_batch_write — Schreiben mehrerer Bereiche in einem API-Aufruf

• 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 — bedingte Formatierungsregel hinzufügen

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

Installation

Siehe SETUP.md für die einmalige GCP-Einrichtung (~45 Min. für v1, ~5 Min. zusätzlich, um Drive/Docs/Tabellen für v2 zu aktivieren).

Nach der Einrichtung:

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

Bei Claude Code registrieren

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

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

Upgrade von v1 → v2

v2 fügt Drive + Docs + Tabellen-Scopes hinzu. Jedes autorisierte Konto muss einmalig erneut OAuth durchführen, damit Google die neuen Scopes gewährt. Siehe SETUP.md Schritt 6b.

Roadmap

• v3: Gmail-Filter, Abwesenheitsnotiz, Push-Benachrichtigungen (Gmail Watch), Kalender-ACL/Delegierung, Slides, Formulare, Aufgaben

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

Lizenz

MIT