Google Tasks MCP

Ein MCP-Server, der es KI-Agenten ermöglicht, die Google Tasks eines Benutzers zu lesen und zu verwalten. Er verwendet die offizielle Google Tasks API, OAuth-2.0-Desktop-App-Anmeldedaten und das MCP-TypeScript-SDK über stdio.

Funktionen

• Aufgabenlisten auflisten, anzeigen, erstellen, umbenennen und löschen

• Aufgaben mit API-Paginierung auflisten und filtern

• Aufgaben erstellen, bearbeiten, abschließen, wieder öffnen, verschieben, neu anordnen und löschen

• Unteraufgaben mit parent und previous erstellen und verschieben

• Abgeschlossene Aufgaben löschen

• MCP-Sicherheitsannotationen plus explizite Bestätigung für destruktive Operationen

• OAuth-Refresh-Token, das außerhalb des Repositorys mit Berechtigungen nur für den Eigentümer gespeichert wird

Voraussetzungen

• Node.js 20 oder neuer

• Ein Google-Konto

• Ein Google-Cloud-Projekt mit aktivierter Google Tasks API

1. Google Cloud konfigurieren

1. Öffnen Sie die Google Cloud Console.

2. Erstellen Sie ein Projekt oder wählen Sie eines aus.

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

4. Konfigurieren Sie den OAuth-Zustimmungsbildschirm.

5. Erstellen Sie unter APIs & Services → Credentials eine OAuth-Client-ID mit dem Anwendungstyp Desktop-App.

6. Laden Sie die JSON-Datei des OAuth-Desktop-Clients als client_secret.json herunter und bewahren Sie sie außerhalb dieses Repositorys geschützt auf.

2. Installieren, erstellen und autorisieren

npm install
npm run build
npm run auth -- --client-secret /secure/google/client_secret.json

Der auth-Befehl akzeptiert nur eine JSON-Datei eines Google-OAuth-Desktop-Clients, die das Objekt installed auf oberster Ebene enthält. Er öffnet einen Zustimmungsablauf im Browser und speichert das Tasks-Refresh-Token unter:

~/.config/google-tasks-mcp/token.json

Überschreiben Sie bei Bedarf den Speicherort des generierten Tokens:

GOOGLE_TOKEN_FILE=/secure/google/tasks-token.json \
npm run auth -- --client-secret /secure/google/client_secret.json

Führen Sie für ein installiertes Paket Folgendes aus:

google-tasks-mcp-auth --client-secret /secure/google/client_secret.json

Der Server fordert den vollständigen Scope https://www.googleapis.com/auth/tasks an, da er sowohl Lese- als auch Schreiboperationen bereitstellt. Bei späteren Ausführungen des MCP-Servers wird das gespeicherte Token verwendet und der Zugriff automatisch erneuert; geben Sie client_secret.json nur erneut an, wenn Sie das Projekt autorisieren oder erneut autorisieren. Committen Sie niemals eine der beiden JSON-Dateien.

3. MCP-Host verbinden

Verwenden Sie den erstellten Server direkt aus diesem Checkout. Ersetzen Sie die Pfade durch absolute Pfade auf Ihrem Rechner.

Codex (~/.codex/config.toml)

[mcp_servers.google_tasks]
command = "node"
args = ["/absolute/path/google-task-mcp/dist/index.js"]

[mcp_servers.google_tasks.env]
GOOGLE_TOKEN_FILE = "/Users/you/.config/google-tasks-mcp/token.json"

Hosts mit JSON-Konfiguration

{
  "mcpServers": {
    "google_tasks": {
      "command": "node",
      "args": ["/absolute/path/google-task-mcp/dist/index.js"],
      "env": {
        "GOOGLE_TOKEN_FILE": "/Users/you/.config/google-tasks-mcp/token.json"
      }
    }
  }
}

Starten Sie den MCP-Host nach einer Änderung seiner Konfiguration neu.

Verfügbare Tools

Google Tasks speichert nur den Datumsanteil eines Fälligkeitszeitstempels. Eine über die API gesendete Uhrzeit wird verworfen. Aufgabentitel sind auf 1.024 Zeichen und Notizen auf 8.192 Zeichen begrenzt.

Mit MCP Inspector testen

npm run build
npm run inspect

Das stdio-Protokoll verwendet ausschließlich stdout. Laufzeitdiagnosen werden daher auf stderr geschrieben.

Paket für die Verteilung erstellen

Erstellen Sie ein installierbares npm-Tarball:

npm pack

Nach der Veröffentlichung des Pakets kann ein Host es wie folgt starten:

{
  "command": "npx",
  "args": ["-y", "google-tasks-mcp@0.1.0"],
  "env": {
    "GOOGLE_TOKEN_FILE": "/secure/google/tasks-token.json"
  }
}

Für einen Benutzer an einem Arbeitsplatz ist stdio plus ein lokales Token die einfachste und sicherste Bereitstellung. Für mehrere Benutzer oder einen gehosteten Dienst verwenden Sie MCP Streamable HTTP und implementieren Sie OAuth-Sitzungen pro Benutzer sowie eine verschlüsselte serverseitige Tokenspeicherung; verwenden Sie nicht dasselbe Refresh-Token für mehrere Benutzer.

Referenzen

• Google Tasks API REST-Referenz

• Google Tasks-Ressourcenfelder

• Google Tasks-Sortierung

• Google OAuth 2.0

• MCP TypeScript SDK