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 auflistenget-tasklist- Details zu einer bestimmten Aufgabenliste abrufencreate-tasklist- Eine neue Aufgabenliste erstellenupdate-tasklist- Eine bestehende Aufgabenliste aktualisierendelete-tasklist- Eine Aufgabenliste löschen
Aufgabenverwaltung
list-tasks- Alle Aufgaben in einer Aufgabenliste auflisten, einschließlich paginierter Ergebnisseget-task- Details zu einer bestimmten Aufgabe abrufencreate-task- Eine neue Aufgabe erstellenupdate-task- Eine bestehende Aufgabe aktualisierendelete-task- Eine Aufgabe löschencomplete-task- Eine Aufgabe als erledigt markierenmove-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
Gehen Sie zur Google Cloud Console
Erstellen Sie ein neues Projekt
Navigieren Sie zu "APIs & Dienste" > "Bibliothek"
Suchen Sie nach "Google Tasks API" und aktivieren Sie diese
Gehen Sie zu "APIs & Dienste" > "Anmeldedaten"
Klicken Sie auf "Anmeldedaten erstellen" > "OAuth-Client-ID"
Konfigurieren Sie den OAuth-Zustimmungsbildschirm (für den persönlichen Gebrauch ist "Extern" in Ordnung)
Wählen Sie als Anwendungstyp "Webanwendung"
Fügen Sie "http://localhost:3000/oauth2callback" als autorisierte Weiterleitungs-URI hinzu
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/oauth2callbackUmgebungsvariablen:
GOOGLE_CLIENT_ID(erforderlich) - Ihre Google OAuth-Client-IDGOOGLE_CLIENT_SECRET(erforderlich) - Ihr Google OAuth-Client-GeheimnisGOOGLE_REDIRECT_URI(optional) - OAuth-Weiterleitungs-URI (Standard isthttp://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
Abhängigkeiten installieren:
npm installServer erstellen:
npm run build4. 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-tasksClaude for Desktop
Installieren Sie Claude for Desktop
Öffnen Sie die Claude-Konfigurationsdatei:
MacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
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:
Verwenden Sie das Tool
authenticate, um eine Autorisierungs-URL zu erhaltenBesuchen Sie die URL in Ihrem Browser und melden Sie sich mit Ihrem Google-Konto an
Nach der Autorisierung erhalten Sie einen Code auf der Browserseite
Verwenden Sie das Tool
set-auth-codemit diesem Code, um die Authentifizierung abzuschließenSie 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.jsonengines)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üssenValidierung 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_URIangepasst werden
Screenshots
Claude Desktop

Cursor

Lizenz
Dieses Projekt dient nur zu Demonstrationszwecken. Verwendung auf eigene Gefahr.
Available Tools
15 toolsauthenticateB
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
Scored across 15 tools
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.
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).
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.
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
Related MCP Connectors
MCP server for Google Tasks: review, plan and tidy your tasks by asking. Deletes always ask first.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Simple, fast todo app: manage tasks, projects and tags from Claude and other MCP clients.
Related MCP Servers
- AlicenseAqualityBmaintenanceA Model Context Protocol server that connects Claude Desktop to AI Note task management, enabling task creation, updates and management through natural language conversations.5157 npm1MIT
- AlicenseNot gradedqualityBmaintenanceA Model Context Protocol (MCP) server that brings your Google Tasks into Claude and other MCP-compatible clients, enabling task and task list management through natural conversation.49 npm14MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables Claude to fully manage Google Calendar, including events, calendars, sharing, and availability checks through natural language.1MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to manage Google Tasks, including creating, updating, deleting, and searching tasks and task lists via OAuth2 authentication.23 npm1Apache 2.0