Skip to main content
Glama
Google Tasks MCP Server

Google Tasks MCP Server

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.

[!NOTE] Der gesamte Code in diesem Projekt (bis auf einige Bearbeitungen) wurde "vibe coded" (siehe Wikipedia) – generiert mit Claude/Copilot basierend auf meinen Anweisungen.

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 Tasks 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
  1. 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

Claude Desktop Screenshot

Cursor

Cursor Screenshot

Lizenz

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

Available Tools

15 tools
authenticateB

Get URL to authenticate with Google Tasks

Inputs: no named parameters.

clear-completed-tasksC

Clear all completed tasks from a task list

Inputs: tasklist (required).

complete-taskC

Mark a task as completed

Inputs: tasklist (required), task (required).

create-taskC

Create a new task in a task list

Inputs: tasklist (required), title (required), notes, due.

create-tasklistC

Create a new task list

Inputs: title (required).

delete-taskC

Delete a task

Inputs: tasklist (required), task (required).

delete-tasklistC

Delete a task list

Inputs: tasklist (required).

get-taskC

Get a specific task by ID

Inputs: tasklist (required), task (required).

get-tasklistC

Get a task list by ID

Inputs: tasklist (required).

list-tasklistsB

List all task lists

Inputs: no named parameters.

list-tasksC

List all tasks in a task list

Inputs: tasklist (required), showCompleted, showHidden, showDeleted.

move-taskC

Move a task to another position

Inputs: tasklist (required), task (required), parent, previous.

set-auth-codeC

Set the authentication code received from Google OAuth flow

Inputs: code (required).

update-taskC

Update an existing task

Inputs: tasklist (required), task (required), title, notes, +2 more.

update-tasklistC

Update an existing task list

Inputs: tasklist (required), title (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 15 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity. Each tool targets specific resources (tasks or tasklists) and actions (create, get, list, update, delete, complete, clear, move), making it easy for an agent to select the right tool. The separation between task operations and tasklist operations is particularly clear.

    Naming Consistency5/5

    The naming follows a perfectly consistent verb-noun pattern throughout all 15 tools. Every tool uses snake_case with clear action verbs (create, get, list, update, delete, etc.) followed by the resource name (task, tasklist), and multi-word resources use hyphens consistently (e.g., clear-completed-tasks).

    Tool Count5/5

    With 15 tools, this server is well-scoped for managing Google Tasks. Each tool earns its place by covering essential CRUD operations for both tasks and tasklists, plus additional workflow actions like moving tasks and clearing completed ones. The count is appropriate for the domain without being overwhelming.

    Completeness5/5

    The tool surface provides complete coverage for the Google Tasks domain. It includes full CRUD operations for both tasks and tasklists, plus lifecycle actions like completing tasks, moving tasks, and clearing completed tasks. Authentication tools are also included, ensuring no dead ends for agents.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches