TickTick MCP-Server

Ein Model Context Protocol (MCP) -Server für TickTick, der die Interaktion mit Ihrem TickTick-Aufgabenverwaltungssystem direkt über Claude und andere MCP-Clients ermöglicht.

Merkmale

• 📋 Alle Ihre TickTick-Projekte und -Aufgaben anzeigen

• ✏️ Erstellen Sie neue Projekte und Aufgaben durch natürliche Sprache

• 🔄 Aktualisieren Sie vorhandene Aufgabendetails (Titel, Inhalt, Daten, Priorität)

• ✅ Aufgaben als erledigt markieren

• 🗑️ Aufgaben und Projekte löschen

• 🔄 Vollständige Integration mit der offenen API von TickTick

• 🔌 Nahtlose Integration mit Claude und anderen MCP-Clients

Related MCP server: Mattermost MCP Server

Voraussetzungen

• Python 3.10 oder höher

• uv - Schneller Python-Paketinstaller und -Resolver

• TickTick-Konto mit API-Zugriff

• TickTick-API-Anmeldeinformationen (Client-ID, Client-Geheimnis, Zugriffstoken)

Installation

1. Klonen Sie dieses Repository :

   git clone https://github.com/jacepark12/ticktick-mcp.git cd ticktick-mcp

2. Mit uv installieren :

   # Install uv if you don't have it already curl -LsSf https://astral.sh/uv/install.sh | sh # Create a virtual environment uv venv # Activate the virtual environment # On macOS/Linux: source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install the package uv pip install -e .

3. Authentifizieren Sie sich mit TickTick :

   # Run the authentication flow uv run -m ticktick_mcp.cli auth

   Dies wird:

   • Fragen Sie nach Ihrer TickTick-Client-ID und Ihrem Client-Geheimnis

   • Öffnen Sie ein Browserfenster, damit Sie sich bei TickTick anmelden können

   • Speichern Sie Ihre Zugriffstoken automatisch in einer .env Datei

4. Testen Sie Ihre Konfiguration :

   uv run test_server.py

   Dadurch wird überprüft, ob Ihre TickTick-Anmeldeinformationen ordnungsgemäß funktionieren.

Authentifizierung mit TickTick

Dieser Server verwendet OAuth2 zur Authentifizierung bei TickTick. Die Einrichtung ist unkompliziert:

1. Registrieren Sie Ihre Anwendung im TickTick Developer Center

   • Legen Sie die Umleitungs-URI auf http://localhost:8000/callback

   • Notieren Sie Ihre Client-ID und Ihr Client-Geheimnis

2. Führen Sie den Authentifizierungsbefehl aus:

   uv run -m ticktick_mcp.cli auth

3. Folgen Sie den Anweisungen, um Ihre Client-ID und Ihr Client-Geheimnis einzugeben

4. Es öffnet sich ein Browserfenster, in dem Sie die Anwendung mit Ihrem TickTick-Konto autorisieren können

5. Nach der Autorisierung werden Sie zurück zur Anwendung weitergeleitet und Ihre Zugriffstoken werden automatisch in der .env Datei gespeichert

Der Server übernimmt die Token-Aktualisierung automatisch, sodass Sie sich nicht erneut authentifizieren müssen, es sei denn, Sie widerrufen den Zugriff oder löschen Ihre .env Datei.

Authentifizierung mit Dida365

Dida365 ist die chinesische Version von TickTick. Der Authentifizierungsprozess ähnelt dem von TickTick. Befolgen Sie diese Schritte, um die Dida365-Authentifizierung einzurichten:

1. Registrieren Sie Ihre Anwendung im Dida365 Developer Center

   • Legen Sie die Umleitungs-URI auf http://localhost:8000/callback

   • Notieren Sie Ihre Client-ID und Ihr Client-Geheimnis

2. Fügen Sie Ihrer .env Datei Umgebungsvariablen hinzu:

   TICKTICK_BASE_URL='https://api.dida365.com/open/v1' TICKTICK_AUTH_URL='https://dida365.com/oauth/authorize' TICKTICK_TOKEN_URL='https://dida365.com/oauth/token'

3. Befolgen Sie die gleichen Authentifizierungsschritte wie für TickTick

Verwendung mit Claude für Desktop

1. Installieren Sie Claude für Desktop

2. Bearbeiten Sie Ihre Claude for Desktop-Konfigurationsdatei:

   macOS :

   nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Windows :

   notepad %APPDATA%\Claude\claude_desktop_config.json

3. Fügen Sie die TickTick MCP-Serverkonfiguration unter Verwendung absoluter Pfade hinzu:

   { "mcpServers": { "ticktick": { "command": "<absolute path to uv>", "args": ["run", "--directory", "<absolute path to ticktick-mcp directory>", "-m", "ticktick_mcp.cli", "run"] } } }

4. Starten Sie Claude für Desktop neu

Sobald die Verbindung hergestellt ist, werden die in Claude verfügbaren TickTick MCP-Servertools angezeigt, die durch das Symbol 🔨 (Tools) gekennzeichnet sind.

Verfügbare MCP-Tools

Beispiel-Eingabeaufforderungen für Claude

Hier sind einige Beispielaufforderungen, die Sie mit Claude verwenden können, nachdem Sie eine Verbindung zum TickTick MCP-Server hergestellt haben:

• „Zeig mir alle meine TickTick-Projekte“

• „Erstellen Sie in meinem Arbeitsprojekt eine neue Aufgabe mit dem Namen ‚MCP-Serverdokumentation fertigstellen‘ mit hoher Priorität.“

• „Alle Aufgaben in meinem persönlichen Projekt auflisten“

• „Markieren Sie die Aufgabe ‚Lebensmittel kaufen‘ als erledigt“

• „Erstellen Sie ein neues Projekt mit dem Namen ‚Urlaubsplanung‘ in Blau.“

• „Wann ist meine nächste Deadline in TickTick?“

Entwicklung

Projektstruktur

Authentifizierungsablauf

Das Projekt implementiert einen vollständigen OAuth 2.0-Flow für TickTick:

1. Ersteinrichtung : Der Benutzer gibt seine TickTick-API-Client-ID und sein Geheimnis ein

2. Browser-Autorisierung : Der Benutzer wird zu TickTick umgeleitet, um Zugriff zu gewähren

3. Token-Empfang : Ein lokaler Server empfängt den OAuth-Rückruf mit dem Autorisierungscode

4. Token-Austausch : Der Code wird gegen Zugriffs- und Aktualisierungstoken eingetauscht

5. Token-Speicherung : Token werden sicher in der lokalen .env Datei gespeichert

6. Token-Aktualisierung : Der Client aktualisiert das Zugriffstoken automatisch, wenn es abläuft

Dies vereinfacht die Benutzererfahrung, indem der gesamte OAuth-Flow programmgesteuert gehandhabt wird.

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/amazing-feature )

3. Übernehmen Sie Ihre Änderungen ( git commit -m 'Add some amazing feature' )

4. Pushen zum Zweig ( git push origin feature/amazing-feature )

5. Öffnen einer Pull-Anfrage

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.