Google Workspace MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

12 Dienste in einem Server: Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search
Gestufte Toolsets (core / extended / complete) halten die Tool-Liste überschaubar
OAuth 2.0 + 2.1 mit Multi-User-Bearer-Token-Modus für gehostete Deployments
Stateless-Modus für Docker / Kubernetes
Verschlüsselter lokaler Token-Cache; optionaler GCS-gesicherter Credential-Speicher

Live-Demo

In der Praxis

google-workspace-mcp.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "google-workspace-mcp",
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "google-workspace-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "workspace-mcp",
          "--tool-tier",
          "core"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add google-workspace-mcp -- uvx workspace-mcp --tool-tier core

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Google Workspace MCP

Gmail-Posteingang auf null bringen mit Claude als Assistent

👤 Alle mit mehr als 200 ungelesenen E-Mails ⏱ ~25 min beginner

Wann einsetzen: Montag morgen und der Posteingang ist eine Mauer.

Voraussetzungen

Google Cloud OAuth-Client — OAuth 2.0-Credentials in console.cloud.google.com erstellen, client_secret.json herunterladen
Server installiert — uvx workspace-mcp --tool-tier core (erster Aufruf öffnet Browser für OAuth)

Ablauf

Posteingang kategorisieren

Use google-workspace-mcp. List unread mail from the last 7 days. Bucket into: action-required, FYI, newsletters, automated.✓ Kopiert

→ Anzahl pro Kategorie plus Betreff-Beispiele
Niedrigwertige Kategorien automatisch archivieren

Archive everything in newsletters + automated. Don't touch action-required.✓ Kopiert

→ N archiviert, 0 action-required betroffen
Antworten entwerfen

For each action-required email, draft a 2-line reply in my voice. Save as drafts, don't send.✓ Kopiert

→ Entwürfe in Gmail sichtbar; du überarbeitest und sendest

Ergebnis: Posteingang auf unter 20 reduziert, Antworten entworfen aber nicht gesendet — volle menschliche Kontrolle bleibt erhalten.

Fallstricke

Vollen Gmail-Scope gewährt und bereut — Verwende --tool-tier core — kein send_email-Tool bis du explizit auf extended umstellst

Kombinieren mit: filesystem

Wöchentlichen Statusbericht aus Calendar + Docs-Aktivitäten generieren

👤 Entwickler und Manager, die wöchentliche Updates schreiben ⏱ ~10 min beginner

Wann einsetzen: Freitag nachmittag und du hast vergessen, was du diese Woche gemacht hast.

Ablauf

Kalender abrufen

Use google-workspace-mcp. List meetings I attended Mon–Fri this week (skip declined). For each, give 1-line context.✓ Kopiert

→ Chronologische Liste mit kurzem Kontext pro Meeting
Dokument-Aktivität abrufen

List Drive docs I edited or commented on this week. Group by project.✓ Kopiert

→ Gruppierte Dokumentliste mit Bearbeitungs-/Kommentarzählungen
Update entwerfen

Combine into a 6-bullet weekly update — what I shipped, what's blocked, what's next.✓ Kopiert

→ Versandfertiger Slack/E-Mail-Entwurf

Ergebnis: Ein Wochenupdate, das 3 Minuten statt 30 dauert, gestützt auf tatsächliche Artefakte.

Fallstricke

Kalender voller wiederkehrender 1:1s verstopft den Bericht — Nach Ereignistitelmustern oder Teilnehmerzahl filtern — Claude bitten, wiederkehrende 1:1s standardmäßig zu überspringen

Strukturierte Daten aus unstrukturierten Sheets extrahieren und Ergebnisse zurückschreiben

👤 Ops, Finanzen, alle, die viel in Tabellen arbeiten ⏱ ~20 min intermediate

Wann einsetzen: Du hast ein Sheet mit 1000 Zeilen Freitext-Beschreibungen und musst sie kategorisieren.

Ablauf

Bereich lesen

Use google-workspace-mcp. Read column B from Sheet 'Q4 expenses' — 1000 rows of vendor descriptions.✓ Kopiert

→ Zeilen geladen; Beispiel angezeigt
Kategorisieren

Categorize each row into: SaaS, hardware, travel, services, other. Show distribution first.✓ Kopiert

→ Verteilungstabelle; Stichprobenbeispiele
Zurückschreiben

Write categories into column F. Add a header. Don't touch other columns.✓ Kopiert

→ Sheet aktualisiert; du prüfst manuell eine Stichprobe

Ergebnis: Kategorisierte Daten im Sheet, Prüfpfad im Chat.

Fallstricke

Claude überschreibt eine Spalte, die wichtig war — Zielspalte immer explizit angeben; einige Zellen vor Massenschreiben prüfen

Meeting-Vorbereitungsdokumente automatisch aus Kalendereinladungen generieren

👤 Alle mit aufeinanderfolgenden Meetings ⏱ ~15 min intermediate

Wann einsetzen: Du hast morgen 5 Meetings und null Kontext.

Ablauf

Morgen scannen

Use google-workspace-mcp. List tomorrow's meetings with attendees and any attached docs.✓ Kopiert

→ Pro-Meeting-Block mit Teilnehmern + verlinkten Docs
Briefings generieren

For each, create a Doc 'Prep — <meeting title>' summarizing attached docs + suggesting 3 questions to ask.✓ Kopiert

→ N Docs erstellt im /Meeting prep/-Ordner

Ergebnis: In jedes Meeting vorbereitet gehen, nicht improvisieren.

Fallstricke

Externe Teilnehmer können dein Vorbereitungsdoc nicht sehen, aber ein geteilter Titel könnte Absichten verraten — Privaten Vorbereitungsordner verwenden; Titel wie 'Prep — <Thema>' statt '<sensibler Deal-Name>'

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

google-workspace-mcp + filesystem

Drive-Docs lokal synchronisieren für Offline-Bearbeitung oder Git-Tracking

Pull all docs in /weekly-updates/ from Drive into ./drive-mirror/ as markdown.✓ Kopiert

google-workspace-mcp + github

Release-Notes zwischen GitHub und einem Doc spiegeln

Take the latest GitHub release notes and append them to the 'Release log' Google Doc.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
search_gmail	query: str (Gmail search syntax), max_results?	E-Mails nach natürlichsprachlichen Kriterien suchen	1 Gmail API call
send_email	to, subject, body, cc?, bcc?	Nur in extended/complete-Stufe — niemals automatisch senden ohne Bestätigung	1 API call
list_calendar_events	calendar_id, time_min, time_max	Ereignisse eines Datumsbereichs abrufen	1 Calendar API call
read_sheet_range	spreadsheet_id, range (A1 notation)	Zellen aus einem Sheet lesen	1 Sheets API call
write_sheet_values	spreadsheet_id, range, values[][]	Sheet-Bereiche mit berechneten Daten aktualisieren	1 API call
create_doc	title, content (markdown)	Neue Docs aus Chat-Ausgaben generieren	1 Docs API call
search_drive	query, mime_type?	Dateien nach Name/Inhalt suchen	1 Drive API call

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Gmail: 250 Quota-Einheiten/Nutzer/Sek.; Calendar: 500 Anfragen/100 Sek.; Sheets: 300 Anfragen/Min./Nutzer
Tokens pro Aufruf: 200–4000 je nach Aufruf (vollständiger E-Mail-Body vs. Metadaten)
Kosten in €: Kostenlos für private Google-Accounts; Workspace-Organisationen können Admin-Einschränkungen haben
Tipp: Verwende --tool-tier core, sofern du Forms/Slides/Apps-Script nicht wirklich brauchst — weniger Tools = kleinerer System-Prompt

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: gmail.readonly calendar.readonly drive.readonly

Credential-Speicherung: Standardmäßig verschlüsselter lokaler Token-Cache; optionaler GCS-gesicherter Speicher für gehostete Umgebungen

Datenabfluss: Direkt zu googleapis.com — kein Drittanbieter-Relay

Niemals gewähren: gmail.send (bis du das Risiko des automatischen Sendens verstehst) drive (vollständiger Lese-/Schreibzugriff überall)

OAuth 2.0 + 2.1 unterstützt; PKCE Public Client wählen, sofern kein Confidential-Client-Setup vorhanden

Fehlerbehebung

Häufige Fehler und Lösungen

OAuth-Callback schlägt fehl / Browser öffnet sich nicht

OAUTH_REDIRECT_PORT auf einen freien Port setzen und neu starten; auf headless-Systemen Device-Flow-Modus verwenden

Prüfen: lsof -i :8080 to confirm port free

403 insufficient_permissions

Mit fehlendem Scope neu authentifizieren; prüfen, ob der OAuth-Client ihn in der Google Cloud Console erlaubt

Prüfen: Decode token at oauth2.googleapis.com/tokeninfo to see granted scopes

Workspace-Admin blockiert den OAuth-Client

Admin bitten, deine Client-ID zur Liste vertrauenswürdiger Apps hinzuzufügen, oder ein privates Google-Konto zum Testen verwenden

Quota bei Massenoperationen überschritten

Backoff hinzufügen; der Server respektiert Retry-After-Header, aber Bulk-Schleifen können trotzdem Per-Sekunde-Limits auslösen

Prüfen: Watch for HTTP 429 in logs

Alternativen

Google Workspace MCP vs. andere

Alternative	Wann stattdessen	Kompromiss
Pipedream MCP	Verwaltetes OAuth + fertige Google-Integrationen ohne Self-Hosting gewünscht	Kostenpflichtig bei größerem Volumen; Daten fließen durch Pipedream
Per-service MCP servers (gmail-mcp, drive-mcp)	Nur ein Google-Dienst benötigt und minimale Scope-Oberfläche gewünscht	Mehrere OAuth-Flows + Token-Caches zu verwalten

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen