TickTick

TickTick

MCP server for TickTick API enabling task management, projects, subtasks, and automation.

43
Stars
16
Forks
0
Releases

Overview

TickTick MCP Server provides an MCP-compliant interface to the TickTick API, enabling intelligent, context-aware task operations and automation across tasks and projects. It exposes a suite of endpoints to manage tasks, subtasks, and projects, including get_task_by_ids, create_task, update_task, complete_task, delete_task, get_user_projects, get_project_by_id, get_project_with_data, create_project, update_project, and delete_project. These endpoints work with TickTickTaskSchema and TickTickProjectSchema, describing tasks and projects with a full range of fields such as titles, descriptions, dates, time zones, reminders, and recurrence rules. The server supports subtasks within parent tasks and projects with color, viewMode (list, kanban, timeline), and kind (TASK, NOTE). OAuth2 authentication is supported for secure API access, accompanied by comprehensive error handling for common issues. Task and project properties align with TickTick conventions: ISO 8601 date formatting, iCalendar TRIGGER reminders, and RFC 5545 RRULE recurrence rules; priority values (0=None, 1=Low, 3=Medium, 5=High) and status values (0=Normal, 2=Completed). Setup guides cover app registration, the first-time authorization flow, and token persistence via .env or environment variables; usage includes NPX, Docker, Claude Desktop integration, and Smithery installation.

Details

Owner
alexarevalo9
Language
TypeScript
License
Updated
2025-12-07

Features

Task Management

Full CRUD for tasks with all supported properties.

Project Management

CRUD for projects with customizable view modes (list, kanban, timeline).

Subtask Support

Full support for managing subtasks within parent tasks.

Complete Task Control

Manage priorities, due dates, reminders, and recurring rules.

OAuth Authentication

OAuth2 implementation for secure API access.

Comprehensive Error Handling

Clear error messages for common issues.

Audience

DevelopersIntegrate TickTick tasks and projects via MCP to enable automation and context-aware workflows in applications.

Tags

TickTickMCPOAuth2Task ManagementProject ManagementSubtasksiCalendarRecurrenceRemindersAutomation