de en es ja ko ru zh

TickTick MCP Server

Name: TickTick MCP Server
Author: jawello

by jawello

Overview Schema Related Servers Score Discussions

Python

Local

TickTick MCP Server -- Die vollständige TickTick-Integration für Claude

License: MIT Version Python Tools Glama

28 Tools. Vollständiges CRUD. Intelligente Abfragen. Mehrfachbedingungen-Filter. Batch-Operationen. GTD-Unterstützung. Dida365-kompatibel.

Verbinde Claude mit deinem TickTick-Konto und verwalte dein gesamtes Aufgabensystem durch natürliche Konversation – Aufgaben erstellen, projektübergreifend suchen, überfällige Aufgaben prüfen, Elemente in Stapeln erstellen und organisiert bleiben, ohne die App zu öffnen.

„Was ist überfällig?" --> Zeigt sofort alle verpassten Fristen in jedem Projekt an.

Warum dieser?

Feature	Dieser Server	TickTick Official MCP	jacepark12
Werkzeuge	28	22	~20
Mehrfachbedingungsfilter	Ja (Priorität + Tag + Datum + Projekt)	Ja	Nein
Aufgabe zwischen Projekten verschieben	Ja	Ja	Nein
Stapelweise abschließen	Ja (bis zu 20)	Ja (bis zu 20)	Nein
Stapelaktualisierung	Ja	Ja	Nein
Ansicht abgeschlossener Aufgaben	Ja	Ja	Nein
Projektübergreifende Suche	Volltextsuche	Ja	Ja
Unteraufgaben	Ja	Nein	Nein
GTD-Fokusansicht	Ja (hohe Priorität + fällig + überfällig)	Nein	Teilweise
Dida365-Unterstützung	Ja (konfigurierbare Basis-URL)	Nein	Ja
Asynchron (httpx)	Ja	N/A	Nein (synchrone Anfragen)
Pydantic-Validierung	Ja (typisierte Eingaben)	N/A	Nein
MCP-Anmerkungen	Ja (readOnly, destructive Hinweise)	N/A	Nein
Selbst gehostet / Open Source	Ja	Nein (gehosteter Dienst)	Ja
Datenschutz	100% lokal, nur deine Tokens	Läuft über TickTick-Server	100% lokal

Related MCP server: TickTick MCP

Schnellstart

Voraussetzungen

TickTick-Konto
Python 3.10+
Claude Code oder Claude Desktop

Schritt 1 – Klonen und installieren

git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Schritt 2 – Eine TickTick-Entwickler-App registrieren

Gehe zu developer.ticktick.com
Klicke auf New App und fülle einen beliebigen Namen ein
Setze OAuth Redirect URL auf: http://localhost:8080/callback
Kopiere deine Client ID und dein Client Secret

Schritt 3 – Authentifizieren

TICKTICK_CLIENT_ID=your_id TICKTICK_CLIENT_SECRET=your_secret .venv/bin/python3 setup_auth.py

Dies öffnet deinen Browser, um die App zu autorisieren. Klicke auf Allow – die Tokens werden in ~/.ticktick_mcp/tokens.json gespeichert und automatisch aktualisiert.

Schritt 4 – Bei Claude Code registrieren

claude mcp add ticktick \
  -e TICKTICK_CLIENT_ID=your_id \
  -e TICKTICK_CLIENT_SECRET=your_secret \
  -- /path/to/ticktick-mcp/.venv/bin/python3 /path/to/ticktick-mcp/server.py

Für Claude Desktop

Füge zu deiner claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "ticktick": {
      "type": "stdio",
      "command": "/path/to/ticktick-mcp/.venv/bin/python3",
      "args": ["/path/to/ticktick-mcp/server.py"],
      "env": {
        "TICKTICK_CLIENT_ID": "your_id",
        "TICKTICK_CLIENT_SECRET": "your_secret"
      }
    }
  }
}

Schritt 5 – Den Produktivitäts-Skill hinzufügen (optional)

mkdir -p ~/.claude/skills/ticktick
cp skills/ticktick/SKILL.md ~/.claude/skills/ticktick/

Dida365-Unterstützung

Für Dida365 (die chinesische Version von TickTick) setze diese Umgebungsvariablen:

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

Verwendungsbeispiele

Du sagst	Was passiert
„Erinnere mich daran, am Freitag den Zahnarzt anzurufen"	Aufgabe mit Fälligkeitsdatum erstellt
„Füge 'Q1-Bericht überprüfen' zu Arbeit hinzu, hohe Priorität"	Aufgabe im Projekt Arbeit, Priorität 5
„Was ist überfällig?"	Zeigt alle überfälligen Aufgaben projektübergreifend
„Worauf sollte ich mich konzentrieren?"	GTD-Ansicht: hohe Priorität + heute fällig + überfällig
„Suche nach allem zum Thema 'Budget'"	Volltextsuche über alle Projekte
„Zeig mir alle Aufgaben mit hoher Priorität"	Filtert nach Priorität=5 projektübergreifend
„Was ist diese Woche fällig?"	Aufgaben, die in den nächsten 7 Tagen fällig sind
„Erstelle Aufgaben: Milch kaufen, John anrufen, Bericht einreichen"	Erstellt 3 Aufgaben in einem Stapel
„Erstelle ein Projekt namens 'Urlaubsplanung'"	Neues Projekt erstellt
„Füge Unteraufgabe 'Sonnenschutz kaufen' unter der Urlaubsaufgabe hinzu"	Unteraufgabe erstellt
„Ich habe die Zahnarztaufgabe erledigt"	Aufgabe als abgeschlossen markiert
„Lösche das alte Sprint-Projekt"	Projekt und alle Aufgaben gelöscht

MCP-Tools-Referenz

Projekte (5 Tools)

Tool	Beschreibung
`ticktick_list_projects`	Liste alle Projekte mit IDs, Namen, Farben
`ticktick_get_project`	Details eines bestimmten Projekts abrufen
`ticktick_get_project_with_tasks`	Projektdetails + alle unerledigten Aufgaben in einem Aufruf abrufen
`ticktick_create_project`	Ein neues Projekt erstellen (Name, Farbe, Ansichtsmodus)
`ticktick_update_project`	Name, Farbe oder Ansichtsmodus eines Projekts aktualisieren
`ticktick_delete_project`	Ein Projekt dauerhaft löschen

Aufgaben – Grundlegendes CRUD (7 Tools)

Tool	Beschreibung
`ticktick_list_tasks`	Alle Aufgaben in einem bestimmten Projekt auflisten
`ticktick_create_task`	Eine Aufgabe erstellen (Titel, Fälligkeitsdatum, Priorität, Projekt, Tags)
`ticktick_get_task`	Vollständige Details einer bestimmten Aufgabe abrufen
`ticktick_update_task`	Titel, Inhalt, Daten oder Priorität aktualisieren
`ticktick_complete_task`	Eine Aufgabe als abgeschlossen markieren
`ticktick_delete_task`	Eine Aufgabe dauerhaft löschen
`ticktick_create_subtask`	Eine Unteraufgabe unter einer übergeordneten Aufgabe erstellen

Aufgaben – Intelligente Abfragen (7 Tools)

Tool	Beschreibung
`ticktick_get_all_tasks`	Alle Aufgaben über alle aktiven Projekte abrufen
`ticktick_search_tasks`	Volltextsuche über Titel, Inhalt, Unteraufgaben
`ticktick_get_tasks_by_priority`	Nach Priorität filtern (Keine/Niedrig/Mittel/Hoch)
`ticktick_get_tasks_due_today`	Heute fällige Aufgaben über alle Projekte
`ticktick_get_overdue_tasks`	Alle überfälligen Aufgaben über alle Projekte
`ticktick_get_tasks_due_this_week`	Aufgaben, die innerhalb der nächsten 7 Tage fällig sind
`ticktick_get_tasks_due_in_days`	Aufgaben, die in genau N Tagen fällig sind

Aufgaben – Stapel & Produktivität (5 Tools)

Tool	Beschreibung
`ticktick_batch_create_tasks`	Mehrere Aufgaben auf einmal erstellen
`ticktick_batch_update_tasks`	Mehrere Aufgaben auf einmal aktualisieren
`ticktick_complete_tasks_bulk`	Bis zu 20 Aufgaben auf einmal als abgeschlossen markieren
`ticktick_move_task`	Eine Aufgabe von einem Projekt in ein anderes verschieben
`ticktick_get_focus_tasks`	GTD-Fokusansicht: hohe Priorität + heute fällig + überfällig

Aufgaben – Erweiterte Filter (2 Tools)

Tool	Beschreibung
`ticktick_filter_tasks`	Mehrfachbedingungsfilter: Priorität + Tag + Datumsbereich + Projekt + Status
`ticktick_get_completed_tasks`	Abgeschlossene Aufgaben in einem Projekt anzeigen

Benutzer (1 Tool)

Tool	Beschreibung
`ticktick_get_user_preferences`	Benutzereinstellungen abrufen (Zeitzone, Wochenstart usw.)

Architektur

ticktick_mcp/server.py # All MCP tools, async httpx, flat tool arguments
server.py              # Thin entry point re-exporting the package
setup_auth.py          # One-time OAuth 2.0 setup (browser-based)
~/.ticktick_mcp/       # Token storage (auto-refreshed)
skills/ticktick/       # Claude skill for natural task language

Design-Entscheidungen:

Überall asynchron – httpx.AsyncClient für nicht blockierende API-Aufrufe
Flache Tool-Argumente – Annotated[T, Field(...)] pro Argument, nicht ein einzelnes params-Objekt: Agenten erzeugen zuverlässig flache Argumente und lassen regelmäßig einen Wrapper weg
MCP-Anmerkungen – readOnlyHint, destructiveHint für sicherere Tool-Nutzung
Automatische Token-Aktualisierung – Tokens werden transparent mit einem 60-Sekunden-Puffer aktualisiert

Fehlerbehebung

„Angegebene Client-ID stimmt nicht überein" – Überprüfe deine Client-ID auf developer.ticktick.com.

Port 8080 bereits belegt – lsof -ti:8080 | xargs kill -9 und dann erneut versuchen.

Tokens abgelaufen – Führe setup_auth.py erneut aus, um frische Tokens zu erhalten.

Claude sieht die Tools nicht – Führe claude mcp list aus, um die Registrierung zu überprüfen.

Mitwirken

Beiträge sind willkommen! Bitte öffne zuerst ein Issue, um zu besprechen, was du ändern möchtest.

git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
# Make your changes to server.py
# Test: python3 -c "from server import mcp; print(len(mcp._tool_manager._tools), 'tools')"

Lizenz

MIT (c) Salen-Project

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

CalmLoop Task Manager
in.calmloop
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Project Management Note Taking
1
platform7n
tech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Communication Project Management Workplace & Productivity
2
constants
io.github.constants-ai
One workspace of tools for Claude and ChatGPT: connect 600+ apps, generate media, build tools.
App Automation Developer Tools Multimedia Processing
1
skr-cloudify-clickup-mcp-server-new
ai.smithery
Manage your ClickUp workspace by creating, updating, and organizing tasks, lists, folders, and tag…
Project Management App Automation Workplace & Productivity
2

Related MCP Servers

ticktick-mcp
App Automation Project Management Workplace & Productivity
abdulhamid-n
A
license
A
quality
C
maintenance
MCP server for TickTick using the official OAuth 2.0 API. Create, list, update, complete, and delete tasks just by talking to Claude.
Updated 5 months ago (2026-04-06 19:38 UTC)
7
3
MIT
TickTick MCP
Project Management Workplace & Productivity
ekkyarmandi
A
license
Not graded
quality
D
maintenance
Enables AI assistants to manage TickTick tasks through natural language, including creating, updating, completing, and deleting tasks, as well as managing projects.
Updated 4 months ago (2026-04-24 02:17 UTC)
14
MIT
mcp-server-ticktick
Project Management Workplace & Productivity
broven
F
license
Not graded
quality
D
maintenance
Enables interacting with TickTick tasks and projects through natural language via Claude and other MCP clients.
Updated 7 months ago (2026-02-13 16:15 UTC)
TickTick MCP Server
Project Management App Automation
AdityaKhandelwal10
F
license
Not graded
quality
D
maintenance
Enables AI assistants to manage TickTick tasks including listing, creating, updating, completing, and deleting tasks, as well as searching and filtering.
Updated 10 months ago (2025-11-07 10:00 UTC)

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jawello/ticktick-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server