gtasks-mcp

Ein Model Context Protocol-Server für Google Tasks – Listen, Suchen, Erstellen, Aktualisieren, Löschen und Leeren von Aufgaben aus Claude (oder jedem MCP-kompatiblen Client).

Adaptiert von zcaceres/gtasks-mcp (MIT), neu aufgebaut mit reinem Node/TypeScript statt Bun, mit aus dem Repository vollständig entfernten Anmeldedaten (siehe Sicherheit unten) und einer vollständigen Testsuite.

Einrichtung

1. Google Cloud OAuth-Client erstellen

1. Gehen Sie zur Google Cloud Console, erstellen Sie ein Projekt (oder verwenden Sie ein vorhandenes).

2. Aktivieren Sie die Google Tasks API (APIs & Dienste → Bibliothek).

3. Konfigurieren Sie den OAuth-Zustimmungsbildschirm (Extern ist für den persönlichen Gebrauch in Ordnung – Sie sind der einzige Testbenutzer).

4. Erstellen Sie Anmeldedaten → OAuth-Client-ID → Anwendungstyp Desktop-App.

5. Laden Sie die JSON-Datei herunter.

2. OAuth-Client-Datei installieren

mkdir -p ~/.gtasks-mcp
mv ~/Downloads/client_secret_*.json ~/.gtasks-mcp/oauth-keys.json

Unter Windows: %USERPROFILE%\.gtasks-mcp\oauth-keys.json.

3. Erstellen und authentifizieren

npm install
npm run build
npm run auth

Dies öffnet ein Browserfenster für den Google-Zustimmungsablauf. Bei Erfolg wird eine credentials.json (Ihr Aktualisierungs-/Zugriffstoken) neben oauth-keys.json in ~/.gtasks-mcp/ geschrieben.

4. Server bei Claude Code registrieren

claude mcp add gtasks -- node /absolute/path/to/gtasks-mcp/dist/index.js

Related MCP server: mcp-google-tasks

Verfügbare Tools

Sicherheit

• Anmeldedaten liegen niemals in diesem Repository. oauth-keys.json (Ihr Google Cloud OAuth-Client) und credentials.json (Ihr persönliches Zugriffs-/Aktualisierungstoken, generiert durch npm run auth) werden beide unter ~/.gtasks-mcp/ gespeichert – im OS-Benutzerkonfigurationsbereich, nicht im Projektverzeichnis. Es gibt keine gitignorierte Datei im Repository, die versehentlich per git add -f hinzugefügt werden könnte; die Geheimnisse sind vom Arbeitsbaum des Repositorys aus überhaupt nicht erreichbar. Siehe src/config.ts für die genauen Pfade.

• credentials.json ist gleichbedeutend mit einem Passwort für Ihre Google Tasks – jeder, der diese Datei hat, kann Ihre Aufgaben lesen/schreiben. Behandeln Sie sie entsprechend (nicht per E-Mail senden, nicht in einem Chat einfügen, nicht an einem gemeinsamen Ort sichern).

• Abhängigkeiten: nur @google-cloud/local-auth, googleapis und @modelcontextprotocol/sdk – alle offiziell (Google / Anthropic). Keine Telemetrie, keine Drittanbieter-Netzwerkaufrufe; jede Anfrage geht an Googles eigene APIs.

• Bekannte, akzeptierte transitive Schwachstellen (npm audit, geprüft am 2026-08-25): mittelschwere Probleme in esbuild/vite (nur Entwicklungswerkzeuge, nicht Teil der Laufzeit) und uuid (über gaxios/googleapis, kein Eingabepfad für nicht vertrauenswürdige Puffer in der tatsächlichen Nutzung dieses Servers). Beide erfordern einen aufwärts gerichteten Major-Versionssprung, um sie zu beheben; überprüfen Sie sie beim nächsten periodischen Abhängigkeitsaudit erneut, anstatt ein ungetestetes Upgrade zu erzwingen.

Entwicklung

npm test        # vitest
npm run lint     # eslint (narrow scope — see eslint.config.js)
npm run typecheck
npm run build