google-tasks-mcp-server

Ein MCP-Server (stdio) zur Bedienung von Google Tasks. Bietet CRUD-Funktionen für Aufgabenlisten und Aufgaben, das Umschalten des Erledigt-Status, Sortieren und Verschieben sowie das Massen-Ausblenden abgeschlossener Aufgaben.

Da die offiziellen Workspace-MCP-Server von Google (Gmail / Calendar / Drive usw.) Tasks nicht enthalten, wurde dieser Server erstellt, um diese Lücke zu füllen.

Designprinzipien

• Anmeldedaten werden über eine Datei übergeben. Der Pfad zu der von GCP heruntergeladenen client_secret_*.json wird über eine Umgebungsvariable angegeben. Der Client-Secret muss also nicht im Klartext in der MCP-Konfigurationsdatei stehen.

• Die Erstauthentifizierung erfolgt über eine separate CLI. Da der MCP-Server stdout für JSON-RPC belegt hat, wird das Protokoll beschädigt, wenn sich Browseraufrufe oder Logs einmischen. Durch die Auslagerung der Authentifizierung in npm run auth werden Konflikte vermieden und Fehler lassen sich leichter zuordnen.

• Der Umfang beschränkt sich auf Tasks. Es wird nur https://www.googleapis.com/auth/tasks angefordert.

• Aktualisierungen verwenden patch. update entfernt nicht angegebene Felder. Deshalb wird für Teilaktualisierungen immer patch eingesetzt.

Related MCP server: Mini Task MCP Server

Einrichtung

1. GCP–Vorbereitung

1. Aktivieren Sie unter APIs & Services → Library die Google Tasks API.

2. Erstellen Sie unter Credentials eine OAuth 2.0 Client-ID. Anwendungstyp: Desktopanwendung.

   • Da der Typ Desktopanwendung einen beliebigen Loopback-Port als Redirect-Ziel verwenden kann, ist eine Registration der Redirect-URI nicht erforderlich.

3. Laden Sie die JSON-Datei herunter (client_secret_xxx.json).

4. Falls der OAuth-Zustimmungsbildschirm den Status „Test" aufweist, fügen Sie Ihr Google-Konto als Testbenutzer hinzu.

2. Build

npm install
npm run build

3. Erstauthentifizierung

Geben Sie den Pfad zu client_secret_*.json an und authentifizieren Sie sich. Der Browser öffnet sich; bestätigen Sie die Zustimmung.

GOOGLE_TASKS_CLIENT_SECRET_PATH=~/path/to/client_secret_xxx.json npm run auth

Das Token wird unter ~/.config/google-tasks-mcp-server/token.json mit den Berechtigungen 0600 gespeichert. Danach wird es automatisch über das Refresh-Token erneuert – dieser Vorgang ist daher nur einmal nötig.

4. Beim MCP-Client registrieren

Für Claude Code:

claude mcp add google-tasks \
  -e GOOGLE_TASKS_CLIENT_SECRET_PATH=$HOME/path/to/client_secret_xxx.json \
  -- node /absolute/path/to/google-tasks-mcp-server/dist/index.js

Für den direkten Eintrag in .mcp.json:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/absolute/path/to/google-tasks-mcp-server/dist/index.js"],
      "env": {
        "GOOGLE_TASKS_CLIENT_SECRET_PATH": "/absolute/path/to/client_secret_xxx.json"
      }
    }
  }
}

Umgebungsvariablen

Tcols

Bei Auslassung von tasklist wird @default (Standard-Aufgabenliste) verwendet.

Aufgabenlisten

Aufgaben

Anmerkungen zur Spezifikation

• In Datumsangaben wird keine Zeit gespeichert. due wird im RFC-3339-Format übergeben, Google Tasks speichert jedoch nur den Datumsteil.

• Zum Nachsehen abschlossener Aufgaben ist showHidden erforderlich. Mit showCompleted: true allein werden nicht Aufgaben zurückgegeben, die in anderen Clients abgeschlossen wurden. Dieser Server ergänzt deshalb showHidden automatisch, wenn showCompleted: true verwendet wird.

• clear-completed-tasks löscht die Aufgaben nicht. Die Aufgaben werden lediglich ausgeblendet, sind aber weiterhin über showHidden: true ausrufbar.

• Der Datumsfilter wird auf „angegebenen Tag einschließen“ korrigiert. dueMax der Google Tasks API ist in Tageseinheiten exklusiv; selbst bei Werten wie 23:59:59 kann es keine Aufgabe mit einem Fälligkeitsdatum desselben Tages zurück (gegeben werden muss also 0:00 Uhr des Folgetags). Weil das der Intuition entgegensteht, normalisiert dieser Server dueMin und dueMax auf Datumsgrenzen und gibt beiden den genau enthaltenen Tag an.

Entwicklung

npm run typecheck   # 型チェックのみ
npm run build       # dist/ に出力
npm run auth        # 初回認証

Lizenz

MIT

Einrichtungsskript

Führen Sie die obigen Schritte in der GCP-Konsole durch (Aktivieren der Tasks API, Erstellen des OAuth-Clients der Art Desktopanwendung, Herunterladen der JSON-Datei) – danach lassen sich die restlichen Schritte gesammelt ausführen.

./scripts/setup.sh

Es sucht automatisch in ~/Downloads nach der Datei client_secret*.json, überprüft den Typ, legt sie unter Berechtigung 600 in ~/.config/google-tasks-mcp-server/ ab – und führt danach Build, Erstauthentifizierung sowie Registrierung des MCP-Servers durch. Liegt die Datei an einem anderen Ordner, geben Sie den Pfad an.

./scripts/setup.sh /path/to/client_secret.json