alexarevalo9/ticktick-mcp-server

MCP Server for the TickTick API, enabling task management, project organization, habit tracking, and more.
Features
- ✅ **Task Management**: Create, read, update, and delete tasks with all available properties
- 📊 **Project Management**: Create, read, update, and delete projects with customizable views
- 📋 **Subtask Support**: Full support for managing subtasks within parent tasks
- 🔄 **Complete Task Control**: Set priorities, due dates, reminders, and recurring rules
- 🔐 **OAuth Authentication**: Full OAuth2 implementation for secure API access
- ⚠️ **Comprehensive Error Handling**: Clear error messages for common issues
Tools
1. get_task_by_ids
- Get a specific task by project ID and task ID
- Inputs:
- projectId (string): Project identifier
- taskId (string): Task identifier
- Returns: Task object matching TickTickTaskSchema
2. create_task
- Create a new task in a project
- Inputs:
- title (string): Task title
- projectId (string): Project id
- content (optional string): Task content
- desc (optional string): Task description
- isAllDay (optional boolean): Is all day task
- startDate (optional string): Task start date in "yyyy-MM-dd'T'HH:mm:ssZ" format
- dueDate (optional string): Task due date in "yyyy-MM-dd'T'HH:mm:ssZ" format
- timeZone (optional string): Task time zone (e.g., "America/Los_Angeles")
- reminders (optional string[]): List of reminder triggers in iCalendar format
- repeatFlag (optional string): Task repeat flag in iCalendar format
- priority (optional number): Task priority (None: 0, Low: 1, Medium: 3, High: 5)
- sortOrder (optional string): Task sort order
- items (optional array): List of subtasks with:
- title (string): Subtask item title
- startDate (optional string): Subtask date in "yyyy-MM-dd'T'HH:mm:ssZ" format
- isAllDay (optional boolean): Is all day subtask item
- sortOrder (optional number): Subtask item sort order
- timeZone (optional string): Subtask timezone
- status (optional number): Completion status (Normal: 0, Completed: 1)
- completedTime (optional string): Completion time in "yyyy-MM-dd'T'HH:mm:ssZ" format
- Returns: Created task object matching TickTickTaskSchema
3. update_task
- Update an existing task
- Inputs:
- taskId (string): Task identifier - Path
- id (string): Task identifier - Body
- projectId (string): Project id
- All optional fields from create_task
- Returns: Updated task object matching TickTickTaskSchema
4. complete_task
- Mark a task as completed
- Inputs:
- taskId (string): Task identifier
- projectId (string): Project identifier
- Returns: void
5. delete_task
- Delete a task from a project
- Inputs:
- taskId (string): Task identifier
- projectId (string): Project identifier
- Returns: void
6. get_user_projects
- Get all projects for the authenticated user
- Inputs: None
- Returns: Array of project objects matching TickTickProjectSchema
7. get_project_by_id
- Get a specific project by ID
- Inputs:
- projectId (string): Project identifier
- Returns: Project object matching TickTickProjectSchema
8. get_project_with_data
- Get project details along with tasks and columns
- Inputs:
- projectId (string): Project identifier
- Returns: Object containing:
- project: Project object matching TickTickProjectSchema
- tasks: Array of task objects matching TickTickTaskSchema
- columns: Optional array of column objects with:
- id (optional string)
- projectId (optional string)
- name (optional string)
- sortOrder (optional number)
9. create_project
- Create a new project
- Inputs:
- name (string): Project name
- color (optional string): Project color (default: '#4772FA')