google-drive-mcp

Ein lokaler MCP-Server, der Claude Code vollumfassenden Google Drive-Zugriff gewährt – suchen, lesen, hochladen, umbenennen, verschieben und Freigabeberechtigungen ändern – auch für Dateien, die bereits in Ihrem Drive vorhanden sind (nicht nur solche, die diese App erstellt).

Er fragt absichtlich den breiten Bereich https://www.googleapis.com/auth/drive an, da die Aufgaben, für die er entwickelt wurde (Umbenennen, Verschieben und Ändern der Freigabe bestehender Kursdateien), mit dem engeren Bereich drive.file unmöglich sind.

Einmalige Einrichtung

Sie führen dies einmal aus. Danach kann jede Claude Code-Sitzung die google-drive-Tools verwenden.

Schritt 1 — Ein Google Cloud-Projekt erstellen (überspringen, falls Sie bereits eines haben)

1. Gehen Sie zu https://console.cloud.google.com/.

2. Obere Leiste → Projekt-Dropdown → New Project.

3. Geben Sie ihm einen Namen wie app-integrations → Create. Warten Sie einige Sekunden und stellen Sie dann sicher, dass dieses Projekt in der oberen Leiste ausgewählt ist.

Schritt 2 — Die Google Drive API aktivieren

1. Gehen Sie zu https://console.cloud.google.com/apis/library/drive.googleapis.com.

2. Bestätigen Sie, dass Ihr Projekt ausgewählt ist → klicken Sie auf Enable.

Schritt 3 — Den OAuth-Zustimmungsbildschirm konfigurieren

1. Gehen Sie zu https://console.cloud.google.com/auth/overview (APIs & Services → OAuth consent screen).

2. Wählen Sie, falls aufgefordert, User Type: External → Create. (External ist für ein persönliches Google-Konto in Ordnung; Sie sind dann einfach ein "test user".)

3. Füllen Sie die Pflichtfelder aus:

   • App name: google-drive-mcp (alles ist in Ordnung)

   • User support email: Ihre E-Mail-Adresse

   • Developer contact email: Ihre E-Mail-Adresse

   • Speichern und fortfahren.

4. Scopes-Seite: Sie müssen hier keine Bereiche hinzufügen – der Server fordert sie zur Authentifizierungszeit an. Speichern und fortfahren.

5. Test users-Seite: Klicken Sie auf + Add users und fügen Sie Ihre eigene Google-E-Mail-Adresse hinzu (Ihr eigenes Google-Konto). Dies ist erforderlich, solange die App im Status "Testing" ist. Speichern und fortfahren.

Sie müssen die App nicht veröffentlichen oder die Google-Verifizierung durchlaufen. Eine App im Status "Testing" funktioniert auf unbestimmte Zeit für die von Ihnen aufgelisteten Testnutzer; ein Aktualisierungstoken für eine Test-App kann nach 7 Tagen Inaktivität ablaufen – falls Drive-Tools jemals mit einem Authentifizierungsfehler fehlschlagen, führen Sie einfach npm run auth (Schritt 6) erneut aus.

Schritt 4 — Den OAuth-Client erstellen (Desktop-App)

1. Gehen Sie zu https://console.cloud.google.com/auth/clients (APIs & Services → Credentials).

2. + Create Credentials → OAuth client ID.

3. Application type: Desktop app. Geben Sie ihm den Namen desktop-mcp → Create.

4. Klicken Sie im Dialog auf Download JSON.

Schritt 5 — Die Client-Datei an den vom Server erwarteten Speicherort legen

Speichern Sie das heruntergeladene JSON unter genau diesem Pfad/Namen:

~/.config/google-drive-mcp/gcp-oauth.keys.json

Wenn es beispielsweise als ~/Downloads/client_secret_XXXX.json heruntergeladen wurde:

mkdir -p ~/.config/google-drive-mcp
mv ~/Downloads/client_secret_*.json ~/.config/google-drive-mcp/gcp-oauth.keys.json

Schritt 6 — Autorisieren (einmalig)

cd ~/mcp-servers/google-drive-mcp
npm run auth

Dies gibt eine URL aus und öffnet Ihren Browser. Melden Sie sich mit dem Google-Konto an, dessen Drive Sie verwalten möchten. Sie sehen eine Warnung "Google hat diese App nicht verifiziert" (erwartet, da die App sich im Test befindet) → Advanced → Go to google-drive-mcp (unsafe) → Continue → erlauben Sie die Drive-Berechtigung.

Bei Erfolg schreibt es ~/.config/google-drive-mcp/.gdrive-credentials.json (Ihr Aktualisierungstoken – halten Sie es privat; es ist bereits chmod 600).

Schritt 7 — Verwenden

Der Server ist bereits in ~/.claude.json unter dem Namen google-drive registriert. Starten Sie eine neue Claude Code-Sitzung und die gdrive_*-Tools werden verfügbar sein. (MCP-Server laden beim Sitzungsstart, daher sieht eine vor der Registrierung gestartete Sitzung sie nicht.)

Schneller manueller Rauchtest (optional):

cd ~/mcp-servers/google-drive-mcp && npm start
# prints "google-drive-mcp: connected over stdio", then waits. Ctrl-C to quit.

Werkzeuge

Elemente löschen

gdrive_trash ist das Mittel der Wahl. Es ist umkehrbar, Drive behält gelöschte Elemente 30 Tage lang, und gdrive_untrash legt sie an ihren ursprünglichen Ort zurück.

gdrive_delete ist dauerhaft und nicht wiederherstellbar – nichts landet im Papierkorb. Es erfordert einen confirmName, der exakt mit dem aktuellen Namen des Elements übereinstimmt, was ein Auslesen der Metadaten erzwingt, bevor etwas zerstört wird, sodass eine veraltete oder falsch eingegebene Datei-ID lautstark fehlschlägt, anstatt das falsche Element zu löschen. Das Löschen eines Ordners löscht alles darin.

Registrierung

Registriert in beiden Konfigurationen – sie werden unabhängig voneinander gelesen, daher macht die Registrierung in einer den Server nicht in der anderen verfügbar:

• ~/.claude.json (Claude Code)

• ~/Library/Application Support/Claude/claude_desktop_config.json (Desktop / Cowork)

Identischer Eintrag in jeder:

"google-drive": {
  "command": "/opt/homebrew/bin/node",
  "args": ["/ABSOLUTE/PATH/TO/mcp-servers/google-drive-mcp/index.js"]
}

Der absolute Pfad zu node ist erforderlich, keine stilistische Wahl. Eine App, die vom Finder oder beim Anmelden gestartet wird, erbt den minimalen PATH von launchd (/usr/bin:/bin:/usr/sbin:/sbin), in dem /opt/homebrew/bin/node von Homebrew vollständig unsichtbar ist. Ein bloßes "node" funktioniert jedes Mal, wenn Sie es von einem Terminal aus testen, und schlägt jeden Morgen fehl. ~/mcp-servers/trello-mcp/doctor.py überprüft jeden Server in beiden Konfigurationen darauf.

Wenn Sie die claude-CLI später installieren, lautet der entsprechende Befehl:

claude mcp add --scope user google-drive -- /opt/homebrew/bin/node ~/mcp-servers/google-drive-mcp/index.js

Dateien

• index.js — der MCP-Server (Werkzeugdefinitionen)

• auth.js — einmaliger npm run auth-Loopback-OAuth-Ablauf

• lib-auth.js — gemeinsame OAuth/Konfigurations-Helfer

• ~/.config/google-drive-mcp/gcp-oauth.keys.json — von Ihnen bereitgestellt (Schritt 5)

• ~/.config/google-drive-mcp/.gdrive-credentials.json — erstellt von npm run auth

Für den Lebenslauf / das Portfolio

Hier aufbewahrt, damit eine zukünftige Lebenslauf-Sitzung die ehrliche Version hat, anstatt sie zu rekonstruieren.

Warum dies existiert, obwohl ein Drive-Konnektor dies bereits tut. Es erweitert den integrierten Konnektor, anstatt ihn zu ersetzen. Die Lücke ist Massenarbeit: Das Umbenennen von hundert Dateien, nachdem sich eine Namenskonvention mitten im Projekt ändert, ist von Hand mühsam, mit einem Skript trivial und es lohnt sich, es dauerhaft zu lösen, anstatt nur einmal. Das war der motivierende Fall.

Was ich tatsächlich getan habe: das Ziel und die Einschränkung gesetzt – eine kostenlose Lösung, die bei jedem zukünftigen Projekt die gleiche Zeit spart, kein einmaliges Skript für einen Ordner.

Bekannter operativer Vorbehalt: der Veröffentlichungsstatus der OAuth-App bestimmt, wie lange Aktualisierungstoken gültig sind. Im Status "Testing" laufen sie etwa wöchentlich ab (invalid_grant); die Veröffentlichung der App entfernt diese Grenze für jede Integration, die das Cloud-Projekt teilt.

Aufzählungspunkt für das Portfolio: siehe die gemeinsame Version in ~/mcp-servers/trello-mcp/README.md – diese drei werden am besten zusammen beschrieben.

Vollständige Fallstudie: https://zeno-blade-creator.github.io/projects/personal-integrations.html