TickTick MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TICKTICK_HOST | No | Server host: ticktick (default) or dida365 (China) | ticktick |
| TICKTICK_PASSWORD | Yes | Your TickTick password (for V2 API) | |
| TICKTICK_USERNAME | Yes | Your TickTick email (for V2 API) | |
| TICKTICK_CLIENT_ID | Yes | OAuth2 Client ID from developer portal | |
| TICKTICK_DEVICE_ID | No | Stable 24-char hex device id for the V2 x-device header | |
| TICKTICK_ACCESS_TOKEN | Yes | OAuth2 access token (set by auth wizard) | |
| TICKTICK_CLIENT_SECRET | Yes | OAuth2 Client Secret | |
| TICKTICK_REFRESH_TOKEN | No | OAuth2 refresh token (enables auto-renewal) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ticktick_get_projectsA | List all projects (lists) in the user's TickTick account. Returns project IDs, names, colors, view modes, and whether they are closed. |
| ticktick_get_projectA | Get details for a specific project by its ID. Returns project metadata including name, color, view mode, and permissions. |
| ticktick_get_project_dataA | Get a project along with all its undone tasks and Kanban columns. Useful for seeing the full state of a project. |
| ticktick_create_projectB | Create a new project (list) in TickTick. You can specify the name, color, view mode (list/kanban/timeline), and kind (TASK/NOTE). |
| ticktick_update_projectA | Update an existing project's properties. You can change the name, color, view mode, or kind. |
| ticktick_delete_projectA | Permanently delete a project and all its tasks. This cannot be undone. |
| ticktick_get_taskA | Retrieve a specific task by its project ID and task ID. Returns full task details including subtasks, dates, priority, and content. |
| ticktick_create_taskA | Create a new task in TickTick. Requires a title and project ID. Optionally set content, dates, priority (0=None, 1=Low, 3=Medium, 5=High), reminders, recurring rules, and subtasks. |
| ticktick_update_taskA | Update an existing task. Both task_id and project_id are required. Only the fields you provide will be changed. |
| ticktick_complete_taskB | Mark a task as completed. |
| ticktick_delete_taskA | Permanently delete a task. This cannot be undone. |
| ticktick_batch_create_tasksB | Create multiple tasks at once. Each task requires a title and project_id. |
| ticktick_get_all_tasksA | Get all undone tasks across every active project. Useful for building a full picture of your task list. |
| ticktick_search_tasksA | Search for tasks by text. Matches against task title, content, and subtask titles across all active projects. |
| ticktick_get_tasks_due_todayA | Get all tasks that are due today. Helps you focus on what needs to get done right now. |
| ticktick_get_tasks_due_tomorrowA | Get all tasks that are due tomorrow. |
| ticktick_get_tasks_due_this_weekA | Get all tasks due within the next 7 days. |
| ticktick_get_tasks_due_in_daysB | Get all tasks due within the next N days. |
| ticktick_get_overdue_tasksA | Get all tasks that are past their due date. These need immediate attention. |
| ticktick_get_tasks_by_priorityA | Get all tasks filtered by a specific priority level. Priority values: 0=None, 1=Low, 3=Medium, 5=High. |
| ticktick_get_engaged_tasksA | Get tasks that need immediate engagement: high priority (5), overdue, or due today. Based on GTD methodology. |
| ticktick_get_next_tasksA | Get tasks that are up next: medium priority (3) or due tomorrow. Based on GTD methodology. |
| ticktick_filter_tasksA | Advanced task filtering. Combine multiple criteria: project, priority, date ranges, text search. All filters are AND-combined. |
| ticktick_daily_summaryA | Get a productivity digest: overdue tasks, tasks due today, tasks due tomorrow, and high-priority items. Great for morning planning. |
| ticktick_get_tagsA | List all tags in your TickTick account. Returns tag names, colors, and sort order. |
| ticktick_create_tagA | Create a new tag with an optional color. |
| ticktick_rename_tagA | Rename an existing tag. All tasks with this tag will be updated. |
| ticktick_delete_tagA | Delete a tag. Tasks with this tag will have it removed. |
| ticktick_merge_tagsA | Merge one tag into another. All tasks with the source tag will be re-tagged with the destination tag. |
| ticktick_get_habitsA | List all habits in your TickTick account, including name, frequency, goal, and streak info. |
| ticktick_get_habit_sectionsA | Get habit sections (Morning, Afternoon, Evening, etc.) and which habits belong to each. |
| ticktick_create_habitA | Create a new habit. Set a name, optional goal, unit, frequency, color, and encouragement message. |
| ticktick_delete_habitA | Delete a habit by its ID. This cannot be undone. |
| ticktick_checkin_habitB | Record a check-in for a habit on a specific date. Use today's date in YYYYMMDD format by default. |
| ticktick_get_habit_checkinsA | Get check-in records for one or more habits from a specific date onward. |
| ticktick_get_focus_heatmapA | Get a heatmap of your focus/pomodoro time over a date range. Shows daily focus totals including pomodoro and stopwatch time. |
| ticktick_get_focus_distributionB | Get how your focus time is distributed across tags/categories over a date range. |
| ticktick_get_productivity_statsA | Get your overall productivity statistics: tasks completed, tasks created, pomodoro count, habit check-ins, and productivity score. |
| ticktick_get_columnsA | List all Kanban columns for a project. Only applicable to projects using kanban view mode. |
| ticktick_create_columnA | Add a new column to a kanban-view project. |
| ticktick_delete_columnB | Delete a column from a kanban-view project. |
| ticktick_move_task_to_columnA | Move a task into a different Kanban column within its project. Use ticktick_get_columns to find the destination column ID. The task keeps all its other fields. |
| ticktick_get_project_foldersA | List all project folders (groups) used to organize projects in TickTick. |
| ticktick_create_project_folderB | Create a new folder to organize projects. |
| ticktick_delete_project_folderA | Delete a project folder. Projects inside will be ungrouped, not deleted. |
| ticktick_move_project_to_folderA | Move a project (list) into a folder, or remove it from its folder. Pass a folder_id to move it in; pass an empty string (or "NONE") to take it out of any folder. Use ticktick_get_project_folders to find folder IDs. |
| ticktick_get_completed_tasksA | Get tasks that have been completed. Optionally filter by date range. Great for reviewing what you've accomplished. |
| ticktick_get_trashed_tasksA | Get tasks that have been deleted/trashed. Useful for recovering accidentally deleted items. |
| ticktick_move_taskB | Move a task from one project to another. |
| ticktick_set_task_parentA | Make a task a subtask of another task by setting its parent. Pass an empty parent_id to remove the parent relationship. |
| ticktick_get_user_profileA | Get your TickTick user profile including name, email, timezone, inbox ID, and subscription status. |
| ticktick_get_user_settingsA | Get your TickTick account settings and preferences (timezone, start of week, etc.). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/ChrisJVanek/ticktick-mcp-ratv'
If you have feedback or need assistance with the MCP directory API, please join our Discord server