Google Tasks MCP-Server

Dieser Model Context Protocol (MCP)-Server bietet eine Brücke zwischen MCP-Clients und Google Tasks, mit der Sie Ihre Aufgabenlisten und Aufgaben direkt von Clients wie Claude Desktop, Cursor und Codex aus verwalten können.

Funktionen

Dieser MCP-Server bietet die folgende Funktionalität:

Verwaltung von Aufgabenlisten

• list-tasklists - Alle Ihre Aufgabenlisten auflisten

• get-tasklist - Details zu einer bestimmten Aufgabenliste abrufen

• create-tasklist - Eine neue Aufgabenliste erstellen

• update-tasklist - Eine bestehende Aufgabenliste aktualisieren

• delete-tasklist - Eine Aufgabenliste löschen

Aufgabenverwaltung

• list-tasks - Alle Aufgaben in einer Aufgabenliste auflisten, einschließlich paginierter Ergebnisse

• get-task - Details zu einer bestimmten Aufgabe abrufen

• create-task - Eine neue Aufgabe erstellen

• update-task - Eine bestehende Aufgabe aktualisieren

• delete-task - Eine Aufgabe löschen

• complete-task - Eine Aufgabe als erledigt markieren

• move-task - Eine Aufgabe verschieben (neu sortieren, übergeordnetes Element ändern oder zwischen Aufgabenlisten verschieben)

• clear-completed-tasks - Alle erledigten Aufgaben aus einer Liste entfernen

Related MCP server: Google Search MCP Server

Einrichtungsanleitung

1. Google Cloud-Projekt erstellen & API aktivieren

1. Gehen Sie zur Google Cloud Console

2. Erstellen Sie ein neues Projekt

3. Navigieren Sie zu "APIs & Dienste" > "Bibliothek"

4. Suchen Sie nach "Google Tasks API" und aktivieren Sie diese

5. Gehen Sie zu "APIs & Dienste" > "Anmeldedaten"

6. Klicken Sie auf "Anmeldedaten erstellen" > "OAuth-Client-ID"

7. Konfigurieren Sie den OAuth-Zustimmungsbildschirm (für den persönlichen Gebrauch ist "Extern" in Ordnung)

8. Wählen Sie als Anwendungstyp "Webanwendung"

9. Fügen Sie "http://localhost:3000/oauth2callback" als autorisierte Weiterleitungs-URI hinzu

10. Erstellen Sie die Client-ID und das Geheimnis

2. Umgebungsvariablen konfigurieren

Erstellen Sie eine .env-Datei in diesem Projektverzeichnis:

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback

Umgebungsvariablen:

• GOOGLE_CLIENT_ID (erforderlich) - Ihre Google OAuth-Client-ID

• GOOGLE_CLIENT_SECRET (erforderlich) - Ihr Google OAuth-Client-Geheimnis

• GOOGLE_REDIRECT_URI (optional) - OAuth-Weiterleitungs-URI (Standard ist http://localhost:3000/oauth2callback)

Hinweis: Der Server überprüft beim Start, ob GOOGLE_CLIENT_ID und GOOGLE_CLIENT_SECRET gesetzt sind, und schlägt mit einer klaren Fehlermeldung fehl, falls diese fehlen oder ungültig sind.

3. Server erstellen

1. Abhängigkeiten installieren:

npm install

2. Server erstellen:

npm run build

4. Einen MCP-Client konfigurieren

Codex

Fügen Sie den Server zu ~/.codex/config.toml hinzu:

[mcp_servers.google-tasks]
command = "zsh"
args = ["-lc", "cd /path/to/google-tasks-mcp && exec node build/index.js"]

Ersetzen Sie /path/to/google-tasks-mcp durch den Pfad zu diesem Projekt und starten Sie Codex neu.

Um zu überprüfen, ob der Server registriert ist:

codex mcp list
codex mcp get google-tasks

Claude for Desktop

1. Installieren Sie Claude for Desktop

2. Öffnen Sie die Claude-Konfigurationsdatei:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Fügen Sie die Konfiguration für den Google Tasks MCP-Server hinzu:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/google-tasks-mcp/build/index.js"]
    }
  }
}

Ersetzen Sie den Pfad durch Ihren eigenen Wert und starten Sie Claude for Desktop neu.

Authentifizierungsablauf

Wenn Sie den Google Tasks MCP-Server zum ersten Mal verwenden:

1. Verwenden Sie das Tool authenticate, um eine Autorisierungs-URL zu erhalten

2. Besuchen Sie die URL in Ihrem Browser und melden Sie sich mit Ihrem Google-Konto an

3. Nach der Autorisierung erhalten Sie einen Code auf der Browserseite

4. Verwenden Sie das Tool set-auth-code mit diesem Code, um die Authentifizierung abzuschließen

5. Sie können nun alle anderen Tools verwenden, um mit Google Tasks zu interagieren

Hinweis: Ihre Authentifizierungs-Token (einschließlich Refresh-Token) werden automatisch auf der Festplatte unter ~/.config/google-tasks-mcp/credentials.json mit eingeschränkten Berechtigungen (600) gespeichert. Das bedeutet:

• Sie müssen sich nur einmal authentifizieren - Anmeldedaten bleiben über Server-Neustarts hinweg erhalten

• Automatische Token-Aktualisierung - Zugriffstoken werden automatisch aktualisiert, wenn sie ablaufen (normalerweise nach 1 Stunde), indem das gespeicherte Refresh-Token verwendet wird

• Keine erneute Authentifizierung erforderlich - Nach der Ersteinrichtung müssen Sie sich nicht erneut authentifizieren, es sei denn, Sie widerrufen den Zugriff oder löschen die Anmeldedatei

Anforderungen

• Node.js 20+ (siehe package.json engines)

• Ein MCP-kompatibler Client

• Google Cloud-Projekt mit aktivierter Tasks API

Implementierungsmerkmale

Dieser MCP-Server enthält die folgenden Verbesserungen:

• Persistente Token-Speicherung - Authentifizierungsdaten werden auf der Festplatte (~/.config/google-tasks-mcp/credentials.json) mit eingeschränkten Berechtigungen gespeichert, sodass Sie sich nur einmal authentifizieren müssen

• Validierung von Umgebungsvariablen - Die Start-Validierung stellt sicher, dass erforderliche Anmeldedaten mit klaren Fehlermeldungen konfiguriert sind

• Automatische Token-Aktualisierung - OAuth-Token werden bei Ablauf automatisch aktualisiert, wodurch eine erneute Authentifizierung während aktiver Sitzungen oder nach Neustarts entfällt

• Erweiterte Eingabevalidierung - Umfassende Validierung aller Eingaben, einschließlich ID-Formaten, Zeichenfolgenlängen und RFC 3339-Datumsformaten

• HTML-Bereinigung - OAuth-Callback-Antworten werden bereinigt, um XSS-Schwachstellen zu verhindern

• Graceful Shutdown - Ordnungsgemäße Bereinigung von Ressourcen bei SIGINT/SIGTERM-Signalen

• Typsicherheit - Vollständige TypeScript-Typsicherheit im gesamten Code mit entsprechenden Schnittstellen

• Konfigurierbare Weiterleitungs-URI - Die OAuth-Weiterleitungs-URI kann über die Umgebungsvariable GOOGLE_REDIRECT_URI angepasst werden

Screenshots

Claude Desktop

Cursor

Lizenz

Dieses Projekt dient nur zu Demonstrationszwecken. Verwendung auf eigene Gefahr.