MCP Google Sheets Server

Lesen, schreiben und verwalten Sie Google Sheets über Claude Desktop, Claude Code und jeden MCP-kompatiblen AI-Client.

Ein leichter, produktionsreifer Model Context Protocol (MCP)-Server, der die Google Sheets API für Claude und andere LLM-Agenten bereitstellt. Automatisieren Sie Tabellenkalkulations-Workflows, bauen Sie AI-Agent-Tools, die in Sheets protokollieren, synchronisieren Sie Datenpipelines mit den Tabellen Ihres Teams oder lassen Sie Claude ein Dokument für Sie bearbeiten – alles mit einem einzigen MCP-Server.

Inhaltsverzeichnis

• Warum

• Funktionen

• Schnellstart

• Einrichtung

  • 1. Google Cloud-Projekt erstellen

  • 2. Sheets API aktivieren

  • 3. OAuth 2.0-Anmeldedaten erstellen

  • 4. Server installieren

  • 5. Autorisieren

• Beim MCP-Client registrieren

  • Claude Desktop

  • Claude Code

• Verfügbare Tools

• Anwendungsbeispiele

• Konfiguration

• Sicherheit

• Fehlerbehebung

• Entwicklung

• Lizenz

Warum

Wenn Sie schon einmal wollten, dass Claude ein Google Sheet aktualisiert – einen Job-Tracker, ein Gewohnheitsprotokoll, ein Projekt-Dashboard – ohne das Fenster zu wechseln, dann gibt Ihnen dieser Server das fehlende Werkzeug. Es ist die natürliche Ergänzung zu Anthropics offiziellem Google Drive MCP-Connector (der Dateien liest, aber keine Zellen schreiben kann).

Häufige Workflows:

• Claude Zeilen in einem Job-Bewerbungs-Tracker-Sheet anhängen lassen, während Sie sich bewerben

• Eine Forschungs-Leseliste, wöchentliche Retro oder ein IELTS-Studienprotokoll synchronisieren

• Einem AI-Agenten strukturierte, nachvollziehbare Ausgabe in eine Tabelle geben

• Finanz- oder Betriebs-Dashboards durch natürliche Sprachbefehle automatisieren

Funktionen

• ✅ Lesen Sie jeden Bereich in A1-Notation

• ✅ Aktualisieren Sie Zellenwerte mit RAW- oder USER_ENTERED-Parsing

• ✅ Anhängen von Zeilen an ein beliebiges Blatt (ideal zum Protokollieren)

• ✅ Leeren von Bereichen ohne Formatierung zu löschen

• ✅ Stapelaktualisierung mehrerer Bereiche in einem Aufruf

• ✅ Inspizieren von Tabellen-Metadaten (Blattregisterkarten, Dimensionen)

• 🔐 OAuth 2.0 mit lokalem Token-Speicher und automatischer Aktualisierung

• 📦 TypeScript, ES-Module, minimale Abhängigkeiten

• 🖥️ Funktioniert mit Claude Desktop, Claude Code und jedem MCP-Client über stdio

Schnellstart

# 1. Clone
git clone https://github.com/yangchoi/mcp-google-sheets.git
cd mcp-google-sheets

# 2. Install and build
npm install
npm run build

# 3. Put your Google Cloud OAuth credentials.json here
mkdir -p ~/.config/mcp-google-sheets
cp /path/to/downloaded-credentials.json ~/.config/mcp-google-sheets/credentials.json

# 4. Authorize (opens browser once)
npm run auth

# 5. Register with Claude — see below

Einrichtung

1. Google Cloud-Projekt erstellen

• Öffnen Sie Google Cloud Console.

• Klicken Sie auf Neues Projekt → geben Sie einen beliebigen Namen ein (z. B. mcp-sheets).

2. Sheets API aktivieren

• Öffnen Sie in Ihrem Projekt Google Sheets API.

• Klicken Sie auf Aktivieren.

3. OAuth 2.0-Anmeldedaten erstellen

• Öffnen Sie Anmeldedaten.

• Klicken Sie auf Anmeldedaten erstellen → OAuth-Client-ID.

• Wenn Sie dazu aufgefordert werden, konfigurieren Sie zuerst den OAuth-Zustimmungsbildschirm:

  • Benutzertyp: Extern (es sei denn, Sie befinden sich in einem Workspace mit verfügbarer interner Option)

  • Fügen Sie sich selbst als Testbenutzer hinzu, solange die App im Testing-Modus ist

  • Bereiche können auf dem Zustimmungsbildschirm leer gelassen werden; die App wird sie zur Laufzeit anfordern

• Zurück bei „OAuth-Client-ID erstellen“:

  • Anwendungstyp: Desktop-App

  • Name: beliebig (z. B. mcp-google-sheets)

• Klicken Sie auf JSON herunterladen und speichern Sie es. Dies ist Ihre credentials.json.

Verschieben Sie die Datei in das Standard-Konfigurationsverzeichnis:

mkdir -p ~/.config/mcp-google-sheets
mv ~/Downloads/client_secret_*.json ~/.config/mcp-google-sheets/credentials.json

(Oder setzen Sie GOOGLE_SHEETS_CREDENTIALS_PATH, um auf einen anderen Pfad zu verweisen – siehe Konfiguration.)

4. Server installieren

git clone https://github.com/yangchoi/mcp-google-sheets.git
cd mcp-google-sheets
npm install
npm run build

5. Autorisieren

Führen Sie den einmaligen OAuth-Ablauf aus. Ihr Browser öffnet sich, Sie genehmigen den Zugriff auf Ihre eigenen Sheets, und das resultierende Token wird unter ~/.config/mcp-google-sheets/token.json gespeichert.

npm run auth

Sie sollten im Terminal Authorization complete. Token saved. sehen.

Beim MCP-Client registrieren

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) und fügen Sie hinzu:

{
  "mcpServers": {
    "google-sheets": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-google-sheets/dist/index.js"]
    }
  }
}

Starten Sie Claude Desktop neu. Die Sheets-Tools erscheinen im Tool-Auswahlmenü.

Claude Code

Fügen Sie zu Ihrer Claude Code MCP-Konfiguration hinzu (normalerweise ~/.claude/settings.json unter mcpServers):

{
  "mcpServers": {
    "google-sheets": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-google-sheets/dist/index.js"]
    }
  }
}

Starten Sie Claude Code neu. Bestätigen Sie das Laden der Tools über /mcp.

Verfügbare Tools

Alle Tools erwarten spreadsheetId (zu finden in der Sheet-URL zwischen /d/ und /edit).

Anwendungsbeispiele

Befehlen Sie Claude:

„Schau dir die Tabelle 1abcXYZ... an und füge dem Blatt Applications eine neue Zeile hinzu: Legora, Stockholm, Legal AI, 2026-08-18, pending.“

Claude wird get_spreadsheet_metadata aufrufen, um das Blatt zu finden, und dann append_row mit den Werten.

Oder lesen + zusammenfassen:

„Lies die ersten 20 Zeilen des Blattes Applications in 1abcXYZ... und sag mir, wie viele noch pending sind.“

Claude ruft read_range auf Applications!A1:F20 auf und analysiert das zurückgegebene Array.

Konfiguration

Umgebungsvariablen (alle optional):

Sicherheit

• credentials.json und token.json sind nur lokal und werden niemals an einen anderen Ort als an die OAuth-Server von Google übertragen.

• Beide Dateien sind durch .gitignore abgedeckt; committen Sie sie nicht in die Versionskontrolle.

• Der Server fordert nur den Bereich spreadsheets an – kein Drive-weiter Zugriff, kein Gmail, kein Kalender.

• Die Token-Aktualisierung erfolgt automatisch; es wird kein langlebiges Zugriffstoken offengelegt.

• Der Server benötigt im Normalbetrieb keinen Netzwerk-Listening-Port (der temporäre Port 47319 wird nur während des anfänglichen OAuth-Rückrufs verwendet und sofort danach geschlossen).

Fehlerbehebung

credentials.json not found – Sie haben Schritt 3–4 übersprungen. Überprüfen Sie den Pfad.

Error: access_denied während OAuth – Ihr Google-Konto ist nicht als Testbenutzer auf dem OAuth-Zustimmungsbildschirm eingetragen. Gehen Sie zu OAuth-Zustimmungsbildschirm → fügen Sie Ihre E-Mail unter Testbenutzer hinzu.

insufficient permission beim Aufruf eines Tools – das Token wurde mit einem kleineren Bereich erstellt. Löschen Sie token.json und führen Sie npm run auth erneut aus.

Tool erscheint nicht in Claude – überprüfen Sie, ob der Pfad in Ihrer MCP-Konfiguration absolut ist und auf dist/index.js zeigt (nicht auf src/index.ts). Stellen Sie sicher, dass Sie npm run build ausgeführt haben.

No stored token beim Serverstart – Sie haben Schritt 5 übersprungen. Führen Sie npm run auth aus.

Entwicklung

npm install
npm run dev      # tsc --watch
npm run build    # produces dist/
npm run start    # runs dist/index.js on stdio

Beiträge willkommen. Dies ist ein minimaler Kern; PRs für strukturelle Aktualisierungen (spreadsheets.batchUpdate für Formatierung, Blatt hinzufügen, Filter, geschützte Bereiche) sind willkommen.

Lizenz

MIT