gtasks-mcp - Google Tasks Modellkontextprotokoll-Server

Projektübersicht

gtasks-mcp ist ein Google Tasks Modellkontextprotokoll (MCP)-Server, der speziell für Claude AI entwickelt wurde. Dieses Projekt ermöglicht es Claude, sich direkt in die Google Tasks API zu integrieren und so eine vollständige Verwaltung der Google Tasks zu ermöglichen.

Projektadresse: https://github.com/zcaceres/gtasks-mcp

Hauptfunktionen

Kernwerkzeuge (Tools)

1. search - Aufgaben suchen

• Funktionsbeschreibung: Durchsucht Google Tasks nach Aufgaben
• Eingabeparameter:
  • query (string): Suchanfrage-String
• Rückgabeergebnis: Detaillierte Informationen zu übereinstimmenden Aufgaben

2. list - Aufgaben auflisten

• Funktionsbeschreibung: Listet alle Aufgaben in Google Tasks auf
• Eingabeparameter:
  • cursor (string, optional): Paginierungs-Cursor
• Rückgabeergebnis: Liste aller Aufgaben

3. create - Aufgabe erstellen

• Funktionsbeschreibung: Erstellt eine neue Aufgabe in Google Tasks
• Eingabeparameter:
  • taskListId (string, optional): Aufgabenlisten-ID
  • title (string, erforderlich): Aufgabentitel
  • notes (string, optional): Aufgabennotizen
  • due (string, optional): Fälligkeitsdatum
• Rückgabeergebnis: Bestätigung der Aufgabenerstellung

4. update - Aufgabe aktualisieren

• Funktionsbeschreibung: Aktualisiert eine bestehende Google Tasks Aufgabe
• Eingabeparameter:
  • taskListId (string, optional): Aufgabenlisten-ID
  • id (string, erforderlich): Aufgaben-ID
  • uri (string, erforderlich): Aufgaben-URI
  • title (string, optional): Neuer Aufgabentitel
  • notes (string, optional): Neue Aufgabennotizen
  • status (string, optional): Neuer Aufgabenstatus ("needsAction" oder "completed")
  • due (string, optional): Neues Fälligkeitsdatum
• Rückgabeergebnis: Bestätigung der Aufgabenaktualisierung

5. delete - Aufgabe löschen

• Funktionsbeschreibung: Löscht eine Aufgabe in Google Tasks
• Eingabeparameter:
  • taskListId (string, erforderlich): Aufgabenlisten-ID
  • id (string, erforderlich): Aufgaben-ID
• Rückgabeergebnis: Bestätigung der Aufgabenlöschung

6. clear - Abgeschlossene Aufgaben löschen

• Funktionsbeschreibung: Löscht alle abgeschlossenen Aufgaben in einer Google Tasks Aufgabenliste
• Eingabeparameter:
  • taskListId (string, erforderlich): Aufgabenlisten-ID
• Rückgabeergebnis: Bestätigung der Löschoperation

Ressourcen (Resources)

Der Server bietet Zugriff auf Google Tasks Ressourcen:

• Aufgabenressource (gtasks:///<task_id>)
  • Repräsentiert eine einzelne Aufgabe in Google Tasks
  • Unterstützt das Lesen von Aufgabendetails, einschließlich Titel, Status, Fälligkeitsdatum, Notizen und anderer Metadaten
  • Kann mit den bereitgestellten Tools aufgelistet, gelesen, erstellt, aktualisiert und gelöscht werden

Installation und Konfiguration

Voraussetzungen

1. Google Cloud Projekt erstellen

   • Besuchen Sie die Google Cloud Console, um ein neues Projekt zu erstellen

2. Google Tasks API aktivieren

   • Aktivieren Sie die API in der Google Cloud Console

3. OAuth-Zustimmungsbildschirm konfigurieren

   • Konfigurieren Sie den OAuth-Zustimmungsbildschirm
   • Wählen Sie für die Testumgebung "internal"
   • Fügen Sie den Gültigkeitsbereich hinzu: https://www.googleapis.com/auth/tasks

4. OAuth-Client-ID erstellen

   • Erstellen Sie sie auf der Seite "Anmeldedaten"
   • Wählen Sie als Anwendungstyp "Desktop-App"
   • Laden Sie die JSON-Datei mit den OAuth-Schlüsseln herunter
   • Benennen Sie die Schlüsseldatei in gcp-oauth.keys.json um und platzieren Sie sie im Projektstammverzeichnis

Projekt erstellen

Verwenden Sie den folgenden Befehl, um den Server zu erstellen:

npm run build

Oder verwenden Sie den Überwachungsmodus:

npm run watch

Automatische Installation (empfohlen)

Automatische Installation über Smithery:

npx -y @smithery/cli install @zcaceres/gtasks --client claude

Authentifizierung

1. Starten Sie den Server und authentifizieren Sie sich:

npm run start auth

2. Dadurch wird der Authentifizierungsprozess im Systembrowser geöffnet
3. Schließen Sie den Authentifizierungsprozess ab
4. Die Anmeldeinformationen werden im Projektstammverzeichnis gespeichert (.gdrive-server-credentials.json)

Claude Desktop Integration

Um diesen Server in die Claude Desktop-Anwendung zu integrieren, fügen Sie Folgendes zur Serverkonfiguration der Anwendung hinzu:

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

Technische Merkmale

• Vollständige CRUD-Operationen: Unterstützt das Erstellen, Lesen, Aktualisieren und Löschen von Aufgaben
• Erweiterte Suchfunktion: Kann Aufgaben anhand von Schlüsselwörtern suchen
• Aufgabenstatusverwaltung: Unterstützt das Markieren von Aufgaben als erledigt oder ausstehend
• Paginierungsunterstützung: Bietet Paginierung bei der Verarbeitung großer Aufgabenmengen
• OAuth 2.0-Authentifizierung: Sicherer Google API-Zugriff
• TypeScript-Unterstützung: Bietet Typsicherheit und ein besseres Entwicklungserlebnis

Anwendungsfälle

• Persönliche Aufgabenverwaltung: Verwalten Sie tägliche Aufgaben über die natürliche Sprachinteraktion von Claude
• Projektzusammenarbeit: Verwalten Sie die Aufgabenzuweisung in Teamprojekten mit einem KI-Assistenten
• Automatisierte Workflows: Kombinieren Sie andere Tools, um die Aufgabenverwaltung zu automatisieren
• Produktivitätssteigerung: Erstellen und aktualisieren Sie Aufgaben schnell per Sprache oder Text

Hinweise

• Benötigt ein gültiges Google-Konto und Google Tasks-Zugriffsberechtigungen
• Für die erstmalige Verwendung ist ein OAuth-Authentifizierungsprozess erforderlich
• Es wird empfohlen, die Authentifizierungsdatei in einer Produktionsumgebung sicher aufzubewahren
• Beachten Sie die Google API-Nutzungsquoten und -beschränkungen