Google Drive MCP Server

Lokaler Python-MCP-Server zum Lesen/Schreiben von Google Sheets, Slides und Drive aus Claude-Code-Sitzungen.

So funktioniert es

Der Server verwendet die OAuth-2.0-Desktop-App von GCP. Beim ersten Gebrauch öffnet sich der Browser für den Zustimmungsablauf. Nach der Genehmigung wird eine lokale token.json gespeichert. Bei späteren Ausführungen wird das Token wiederverwendet und bei Ablauf automatisch erneuert – ohne den Browser erneut öffnen zu müssen.

Authentifizierungsdateien:

Related MCP server: google-workspace-mcp-with-script

Ersteinrichtung (erste Ausführung)

1. GCP-Anmeldedaten

1. Gehen Sie zur GCP-Konsole → APIs & Dienste → Anmeldedaten

2. Erstellen Sie eine OAuth-2.0-Client-ID (Typ: Desktop-App)

3. Laden Sie das JSON herunter und speichern Sie es als credentials.json in diesem Ordner

4. Aktivieren Sie die APIs im GCP-Projekt:

   • Google Sheets API

   • Google Slides API

   • Google Drive API

2. Abhängigkeiten installieren

Windows (PowerShell):

cd "C:\Users\<usuario>\Documents\MCP_Servers\googleDrive"
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

macOS / Linux:

cd ~/Documents/MCP_Servers/googleDrive
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Erste Anmeldung (OAuth)

Führen Sie manuell aus, um den Browser zu öffnen und zu autorisieren:

Windows:

.venv\Scripts\activate
python main.py

macOS / Linux:

source .venv/bin/activate
python main.py

Nach der Genehmigung im Browser wird token.json erstellt und der Server startet. Sie können mit Strg+C beenden – das Token bleibt für die nächsten Verwendungen gespeichert.

Bei Claude Code registrieren

Es gibt zwei Möglichkeiten, den MCP-Server zu registrieren:

Option A – Pro Projekt (.mcp.json)

Erstellen Sie eine Datei .mcp.json im Projektstamm. Der MCP ist nur in diesem Projekt aktiv.

Windows:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\main.py"
      ]
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "/Users/<usuario>/Documents/MCP_Servers/googleDrive/.venv/bin/python",
      "args": [
        "/Users/<usuario>/Documents/MCP_Servers/googleDrive/main.py"
      ]
    }
  }
}

Option B – Global für den Benutzer (~/.claude/settings.json)

Fügt den MCP zu den globalen Einstellungen von Claude Code hinzu – verfügbar in allen Projekten.

Bearbeiten Sie ~/.claude/settings.json (Windows: C:\Users\<benutzer>\.claude\settings.json) und fügen Sie den Schlüssel mcpServers hinzu:

Windows:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\main.py"
      ]
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "/Users/<usuario>/Documents/MCP_Servers/googleDrive/.venv/bin/python",
      "args": [
        "/Users/<usuario>/Documents/MCP_Servers/googleDrive/main.py"
      ]
    }
  }
}

Verwenden Sie Option A, wenn der MCP projektspezifisch ist. Verwenden Sie Option B, wenn Sie Zugriff in jedem Projekt wünschen.

Umgebungsvariablen (optional)

Standardmäßig sucht der Server nach credentials.json und token.json im eigenen Ordner. Um die Pfade zu ändern, erstellen Sie eine .env basierend auf der .env.example:

GOOGLE_CREDENTIALS_PATH=credentials.json
GOOGLE_TOKEN_PATH=token.json

Verfügbare Tools (17 Tools)

Google Sheets (7)

Google Slides (7)

Google Drive (3)

Alle Tools akzeptieren eine direkte ID oder eine vollständige Google-URL:

• 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms

• https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms/edit

Fehlerbehebung

invalid_grant / Token abgelaufen ohne automatische Erneuerung

Löschen Sie die token.json und führen Sie python main.py erneut aus, um den OAuth-Ablauf zu wiederholen.

Windows:

Remove-Item ".\token.json"
python main.py

macOS / Linux:

rm token.json
python main.py

API nicht aktiviert

Überprüfen Sie, ob die drei APIs in der GCP-Konsole aktiviert sind: Google Sheets API, Google Slides API, Google Drive API.

MCP erscheint nicht in Claude Code

Überprüfen Sie, ob der Pfad zur Python-Ausführungsdatei korrekt ist:

• Windows: .venv\Scripts\python.exe

• macOS/Linux: .venv/bin/python

Verwenden Sie den absoluten Pfad in .mcp.json oder settings.json – relative Pfade funktionieren nicht.