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
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
- Klonen Sie dieses Repository :
git clone https://github.com/jacepark12/ticktick-mcp.git
cd ticktick-mcp
- 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 .
- Authentifizieren Sie sich mit TickTick :
# Run the authentication flow
uv run -m ticktick_mcp.cli auth
- 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
- Testen Sie Ihre Konfiguration :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:
- 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
- Führen Sie den Authentifizierungsbefehl aus:
uv run -m ticktick_mcp.cli auth
- Folgen Sie den Anweisungen, um Ihre Client-ID und Ihr Client-Geheimnis einzugeben
- Es öffnet sich ein Browserfenster, in dem Sie die Anwendung mit Ihrem TickTick-Konto autorisieren können
- 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:
- 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
- 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'
- Befolgen Sie die gleichen Authentifizierungsschritte wie für TickTick
Verwendung mit Claude für Desktop
- Installieren Sie Claude für Desktop
- Bearbeiten Sie Ihre Claude for Desktop-Konfigurationsdatei:macOS :
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
notepad %APPDATA%\Claude\claude_desktop_config.json
- 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"]
}
}
}
- 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.
| Werkzeug | Beschreibung | Parameter |
|---|
get_projects | Listen Sie alle Ihre TickTick-Projekte auf | Keiner |
get_project | Erhalten Sie Details zu einem bestimmten Projekt | project_id |
get_project_tasks | Alle Aufgaben in einem Projekt auflisten | project_id |
get_task | Abrufen von Details zu einer bestimmten Aufgabe | project_id ID, task_id |
create_task | Erstellen einer neuen Aufgabe | title , project_id , content (optional), start_date (optional), due_date (optional), priority (optional) |
update_task | Aktualisieren einer vorhandenen Aufgabe | task_id , project_id , title (optional), content (optional), start_date (optional), due_date (optional), priority (optional) |
complete_task | Markieren einer Aufgabe als erledigt | project_id ID, task_id |
delete_task | Löschen einer Aufgabe | project_id ID, task_id |
create_project | Erstellen eines neuen Projekts | name , color (optional), view_mode (optional) |
delete_project | Löschen eines Projekts | project_id |
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
ticktick-mcp/
├── .env.template # Template for environment variables
├── README.md # Project documentation
├── requirements.txt # Project dependencies
├── setup.py # Package setup file
├── test_server.py # Test script for server configuration
└── ticktick_mcp/ # Main package
├── __init__.py # Package initialization
├── authenticate.py # OAuth authentication utility
├── cli.py # Command-line interface
└── src/ # Source code
├── __init__.py # Module initialization
├── auth.py # OAuth authentication implementation
├── server.py # MCP server implementation
└── ticktick_client.py # TickTick API client
Authentifizierungsablauf
Das Projekt implementiert einen vollständigen OAuth 2.0-Flow für TickTick:
- Ersteinrichtung : Der Benutzer gibt seine TickTick-API-Client-ID und sein Geheimnis ein
- Browser-Autorisierung : Der Benutzer wird zu TickTick umgeleitet, um Zugriff zu gewähren
- Token-Empfang : Ein lokaler Server empfängt den OAuth-Rückruf mit dem Autorisierungscode
- Token-Austausch : Der Code wird gegen Zugriffs- und Aktualisierungstoken eingetauscht
- Token-Speicherung : Token werden sicher in der lokalen
.env Datei gespeichert - 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.
- Forken Sie das Repository
- Erstellen Sie Ihren Feature-Zweig (
git checkout -b feature/amazing-feature ) - Übernehmen Sie Ihre Änderungen (
git commit -m 'Add some amazing feature' ) - Pushen zum Zweig (
git push origin feature/amazing-feature ) - Öffnen einer Pull-Anfrage
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.