mcp-google-gdrive

Ein MCP-Server für Google Drive, Docs, Sheets und Slides. Ermöglicht KI-Assistenten die Verwaltung von Dateien, Ordnern, Berechtigungen, Labels und dem Papierkorb mit vollem Lese-/Schreibzugriff über mehrere Google-Konten hinweg. Beinhaltet eine automatische Konvertierung von Workspace-Formaten (Docs zu Markdown, Sheets zu CSV/JSON, Slides zu Text).

Tools

Kontoverwaltung

Dateien

Ordner

Papierkorb

Berechtigungen

Labels

Google Docs

Google Sheets

Google Slides

Neuerungen in v2.2

• outputFormat-Parameter — 12 Lese-/Listen-Tools akzeptieren jetzt outputFormat: "json" | "yaml" | "text". Der Standardwert ist json (abwärtskompatibel). Verwenden Sie yaml für strukturierte Ausgaben oder text für kompakte, menschenlesbare Tabellen. Unterstützt bei: list_accounts, list_files, list_folder, list_trash, list_permissions, list_labels, list_file_labels, list_sheets, get_metadata, read_sheet_range, get_slide_thumbnail, search_files.

v2.1

• gdrive_download_file — Lädt jede Datei aus Drive auf einen lokalen Pfad herunter. Workspace-Dateien (Docs, Sheets, Slides) werden automatisch in das angegebene Format exportiert (PDF, DOCX, XLSX, PPTX, CSV, TXT, HTML oder Markdown).

• savePath bei Export-Tools — gdrive_export_doc, gdrive_export_sheet und gdrive_export_slides akzeptieren jetzt einen optionalen savePath-Parameter. Wenn dieser angegeben ist, werden Binärexporte (DOCX, PDF, XLSX, PPTX) auf dem Datenträger gespeichert, anstatt als Base64 zurückgegeben zu werden. Das Weglassen von savePath behält das Verhalten von v2.0 bei.

• gdrive_list_accounts E-Mail-Auflösung — Konten, die von v0.x migriert wurden und "migrated" anstelle einer E-Mail-Adresse anzeigten, werden beim ersten Aufruf automatisch über die Google userinfo-API aufgelöst.

• Dokumentationskorrekturen — gdrive_empty_trash weist auf die eventuelle Konsistenz hin; gdrive_transfer_ownership weist auf die Einschränkung zwischen Organisationen hin.

Ausgabeformate

Alle Lese- und Listen-Tools unterstützen einen outputFormat-Parameter:

Beispiel: gdrive_list_files({ query: "name contains 'report'", outputFormat: "text" }) gibt zurück:

files:
  id             name              mimeType         modifiedTime  size
  -------------  ----------------  ---------------  ------------  ----
  abc123def456   Q1 Report.pdf     application/pdf  2026-04-01    1024
  ghi789jkl012   Q2 Report.docx    application/pdf  2026-03-15    2048
resultCount: 2

Voraussetzungen

• Node.js 18+

• Ein Google Cloud-Projekt mit aktivierten APIs:

  • Google Drive API

  • Google Docs API

  • Google Sheets API

  • Google Slides API

• OAuth2-Anmeldedaten für Desktop-Anwendungen

Einrichtung

1. Erstellen Sie ein Projekt in der Google Cloud Console und aktivieren Sie die Drive-, Docs-, Sheets- und Slides-APIs

2. Erstellen Sie OAuth2-Anmeldedaten (Anwendungstyp: Desktop-App) und laden Sie die JSON-Datei herunter

3. Speichern Sie die Anmeldedatei:

mkdir -p ~/.config/mcp-google-gdrive
cp ~/Downloads/client_secret_*.json ~/.config/mcp-google-gdrive/credentials.json
chmod 600 ~/.config/mcp-google-gdrive/credentials.json

4. Führen Sie den einmaligen Autorisierungsablauf aus:

npx mcp-google-gdrive --auth primary

Dies gibt eine URL für die Google-Zustimmung aus. Nachdem Sie den Zugriff gewährt haben, fügen Sie den Autorisierungscode wieder in das Terminal ein.

Einrichtung mehrerer Konten

Fügen Sie weitere Konten mit eindeutigen Labels hinzu:

npx mcp-google-gdrive --auth work
npx mcp-google-gdrive --auth personal

Jedes Konto erhält eine eigene Token-Datei unter ~/.config/mcp-google-gdrive/tokens/{label}.json. Verwenden Sie den account-Parameter bei jedem Tool, um anzugeben, welches Konto verwendet werden soll, oder rufen Sie gdrive_switch_account auf, um das Standardkonto zu ändern.

Konfiguration

Gemini CLI

Fügen Sie dies zu ~/.gemini/settings.json hinzu:

{
  "mcpServers": {
    "google-gdrive": {
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

watsonx Orchestrate

orchestrate toolkits import --kind mcp \
  --name google-gdrive \
  --description "Google Drive, Docs, Sheets, Slides" \
  --command "npx -y mcp-google-gdrive" \
  --tools "*"

Claude Code

claude mcp add -s user google-gdrive -- npx -y mcp-google-gdrive

VS Code / Cursor

Fügen Sie dies zu .vscode/mcp.json in Ihrem Workspace hinzu:

{
  "mcpServers": {
    "google-gdrive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

Authentifizierung

Der Server verwendet OAuth2 für den Zugriff auf Google Drive. Anmeldedaten werden lokal gespeichert:

• ~/.config/mcp-google-gdrive/credentials.json — OAuth2-Client (wird von allen Konten geteilt)

• ~/.config/mcp-google-gdrive/tokens/{label}.json — Kontospezifische Token (chmod 600)

• ~/.config/mcp-google-gdrive/config.json — Aktives Konto und Kontoregister

Zugriffstoken laufen nach einer Stunde ab und werden automatisch mithilfe der gespeicherten Refresh-Token erneuert. Die Token-Erneuerung erfolgt transparent und erfordert keine Benutzerinteraktion.

Migration von v0.x

Wenn Sie von einer v0.x-Installation mit einem einzelnen Konto aktualisieren, migriert der Server beim ersten Start automatisch Ihre vorhandene token.json zu tokens/primary.json.

Verwandte MCP-Server

• mcp-redhat-account - Red Hat Kontoverwaltung

• mcp-redhat-knowledge - Red Hat Knowledge Base Suche

• mcp-redhat-manpage - RHEL Manpages

• mcp-redhat-subscription - Abonnementverwaltung

• mcp-redhat-support - Support-Fallverwaltung

Lizenz

MIT