Google Task MCP

Ein lokaler MCP-Server und Codex-Plugin zum Auflisten, Erstellen, Aktualisieren, Abschließen, Rückgängigmachen des Abschlusses und Löschen von Google Tasks. Es verwendet OAuth 2.0 und fordert nur den Google Tasks-Bereich an:

https://www.googleapis.com/auth/tasks

Voraussetzungen

• Node.js 20 oder neuer

• Ein Google Cloud-Projekt

• Codex oder einen anderen MCP-Client, der lokale STDIO-Server unterstützt

Related MCP server: Google Tasks MCP Server

Google Cloud-Setup

1. Erstellen oder wählen Sie ein Projekt in der Google Cloud Console.

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

3. Konfigurieren Sie den OAuth-Zustimmungsbildschirm. Fügen Sie sich selbst als Testbenutzer hinzu, während die App sich im Testmodus befindet.

4. Erstellen Sie eine OAuth-Client-ID vom Typ Desktop-App. Fügen Sie http://127.0.0.1:53682/oauth2callback als autorisierte Weiterleitungs-URI hinzu, wenn die Client-Konfiguration die Verwaltung von Weiterleitungs-URIs erlaubt.

Abhängigkeiten installieren

npm install
npm run check

Anmeldeinformationen konfigurieren

Setzen Sie die folgenden Variablen in der Umgebung, die Codex startet. .env.example dokumentiert die erforderlichen Werte; der Server lädt .env absichtlich nicht automatisch.

GOOGLE_TASKS_CLIENT_ID
GOOGLE_TASKS_CLIENT_SECRET
GOOGLE_TASKS_REDIRECT_URI=http://127.0.0.1:53682/oauth2callback

Optional können Sie GOOGLE_TASKS_TOKEN_PATH setzen, um festzulegen, wo das lokale OAuth-Token gespeichert wird.

Als Codex-Plugin verwenden

Das Repository enthält bereits .codex-plugin/plugin.json und .mcp.json. Installieren Sie es über einen lokalen Codex-Plugin-Marktplatz und starten Sie Codex neu, damit der gebündelte STDIO-Server und die Tool-Definitionen geladen werden.

Für die Entwicklung ohne Paketierung konfigurieren Sie den Server direkt in Codex mit:

command: node
args: <absolute-repository-path>/server/index.js

Nachdem Codex verbunden ist, rufen Sie google_tasks_get_authorization_url auf, öffnen Sie die zurückgegebene URL, bestätigen Sie den Zugriff und rufen Sie google_tasks_complete_authorization auf.

Das Aktualisierungstoken wird standardmäßig lokal unter %APPDATA%\google-task-mcp\token.json gespeichert. Setzen Sie GOOGLE_TASKS_TOKEN_PATH, um einen anderen lokalen Pfad zu wählen. Entfernen Sie diese Datei, um das Konto zu trennen.

Tools und Sicherheit

Der Server stellt Tools zur Verfügung, um Aufgabenlisten und Aufgaben aufzulisten, Aufgaben zu erstellen und zu aktualisieren, eine Aufgabe abzuschließen oder den Abschluss rückgängig zu machen und eine Aufgabe zu löschen. Das Löschen wird nur akzeptiert, wenn confirm auf true gesetzt ist; Aufrufer sollten zuerst die genaue zu löschende Aufgabe anzeigen. Andere Änderungen werden sofort auf Google Tasks angewendet.

Die OAuth-Autorisierung erfordert, dass der Loopback-Callback-Listener weiterläuft. Der Browser-Callback zeigt eine einfache Erfolgs- oder Fehlerseite an und gibt niemals Token in der URL oder Tool-Ausgabe preis.

Lokaler Test

Führen Sie npm run check für eine Syntaxprüfung aus. OAuth/API-Aufrufe erfordern konfigurierte Anmeldeinformationen und eine interaktive Browser-Autorisierung.

Datenschutz

OAuth-Anmeldeinformationen und Aufgabendaten verbleiben auf dem lokalen Rechner, mit Ausnahme von Anfragen, die direkt an die APIs von Google gesendet werden. Committen Sie niemals .env oder die generierte Token-Datei. Beide werden durch .gitignore ausgeschlossen.

Lizenz

Veröffentlicht unter der MIT-Lizenz.