TickTick MCP server: manage your TickTick tasks from Claude, ChatGPT or Gemini

• Finds tasks by keyword

  Searches your tasks by keyword and returns matching tasks with their links.

  Try: “Find my task about the dentist”

  Network · search_task

• Lists tasks still to do today, tomorrow or this week

  Lists unfinished tasks for a set range such as today, tomorrow, the last or next 7 days.

  Try: “What tasks do I have today?”

  Network · list_undone_tasks_by_time_query

• Filters tasks by date, list, priority, tag or status

  Finds tasks that match several conditions at once, like high priority in one list with a certain tag.

  Try: “List all my high-priority tasks for this week”

  Network · filter_tasks

• Lists unfinished tasks between two dates

  Lists unfinished tasks between two dates, up to 14 days apart.

  Try: “What's left to do between the 10th and the 20th?”

  Network · list_undone_tasks_by_date

• Shows tasks you finished in a list over a date range

  Lists tasks you completed in a given list between two dates.

  Try: “What tasks did I complete last week?”

  Network · list_completed_tasks_by_date

• Opens the full details of one task

  Returns everything about one task, such as its notes, dates, checklist and tags.

  Try: “Show me the full details of my presentation task”

  Network · get_task_by_id

• Adds a task with a date, priority, list and tags

  Creates a new task with the title, notes, due date, priority, list and tags you give.

  Try: “Create a task: Finish the presentation deck, today at 3 PM, high priority”

  Write · create_task

• Adds several tasks at once

  Creates many tasks in one go, each with its own date, list and other details.

  Try: “Add buy plants today, park this weekend and my friend's birthday next Tuesday to my Life list”

  Write · batch_add_tasks

• Marks a task as done

  Marks a task as completed.

  Try: “Mark Buy milk as completed”

  Write · complete_task

• Changes a task's title, notes, date or priority

  Updates an existing task, such as moving its due date or raising its priority.

  Try: “Move the report task to Friday and make it high priority”

  Write · update_task

• Moves a task to another list

  Moves a task from one list to another.

  Try: “Move Go camping to my Outdoor Activities list”

  Write · move_task

• Changes several tasks at once

  Updates the details of many tasks in one go.

  Try: “Push all my errands tasks to Saturday”

  Write · batch_update_tasks

• Marks up to 20 tasks in a list as done

  Completes several tasks in one list at once, up to 20 per request.

  Try: “Complete Buy milk and Buy daily essentials in my Personal list”

  Write · complete_tasks_in_project

• Ticks off one checklist item inside a task

  Marks a single checklist item inside a task as done.

  Try: “Tick off passport on my packing checklist”

  Write · complete_checklist_item

• Moves a task to the Trash

  Deletes a task by moving it to the Trash, where you can restore it.

  Try: “Delete the old gym task”

  Delete · delete_task

• Lists all your TickTick lists

  Returns every list in your account.

  Try: “What lists do I have?”

  Network · list_projects

• Shows a list with all its unfinished tasks

  Returns a list's details along with every task still to do in it.

  Try: “What unfinished tasks are left in my exam prep list?”

  Network · get_project_with_undone_tasks

• Shows the details of one list

  Returns the settings and details of a single list.

  Try: “Show me the settings of my Work list”

  Network · get_project_by_id

• Opens one task inside a list

  Returns a specific task from a given list.

  Try: “Open the budget task in my Finance list”

  Network · get_task_in_project

• Creates a new list

  Creates a new TickTick list.

  Try: “Create a list called Home Renovation”

  Write · create_project

• Changes a list's settings

  Updates a list's settings, such as its name or color.

  Try: “Rename my Errands list to Weekend”

  Write · update_project

• Lists the sections in a list

  Returns the sections inside a list.

  Try: “What sections are in my Project list?”

  Network · list_columns

• Adds a section to a list

  Creates a new section inside a list.

  Try: “Add a Done section to my Project list”

  Write · create_column

• Renames a section in a list

  Renames a section inside a list.

  Try: “Rename the Ideas section to Backlog”

  Write · update_column

• Lists your folders

  Returns all the folders that group your lists.

  Try: “What folders do I have?”

  Network · list_project_groups

• Creates a folder for lists

  Creates a new folder to group lists.

  Try: “Create a folder called Side Projects”

  Write · create_project_group

• Renames a folder

  Renames a folder.

  Try: “Rename my School folder to University”

  Write · update_project_group

• Removes a folder and ungroups its lists

  Dissolves a folder; the lists inside it stay but are no longer grouped.

  Try: “Remove the Old folder but keep its lists”

  Delete · delete_project_group

• Shows the comments on a task

  Returns every comment on a task.

  Try: “What comments are on the launch task?”

  Network · get_comment

• Adds a comment to a task

  Adds a comment to a task.

  Try: “Comment on the launch task that the venue is booked”

  Write · add_comment

• Deletes a comment

  Deletes a comment from a task.

  Try: “Delete my last comment on the launch task”

  Delete · delete_comment

• Assigns a task to someone in a shared list

  Assigns a task in a shared list to another member.

  Try: “Assign the groceries task to Sam”

  Write · assign_task

• Removes the person assigned to a task

  Clears the assignee from a task.

  Try: “Unassign the groceries task”

  Write · unassign_task

• Lists who is in a shared list

  Returns the members of a shared list.

  Try: “Who is in our Family list?”

  Network · list_project_members

• Lists your tags

  Returns all your tags.

  Try: “What tags do I use?”

  Network · list_tags

• Creates a tag

  Creates a new tag.

  Try: “Create a tag called waiting”

  Write · create_tag

• Renames a tag

  Renames a tag.

  Try: “Rename the tag urgent to today”

  Write · rename_tag

• Changes a tag's color or settings

  Updates a tag's color and other settings.

  Try: “Make the waiting tag orange”

  Write · update_tag

• Deletes a tag and removes it from every task

  Deletes a tag and strips it from all tasks that had it.

  Try: “Delete the someday tag”

  Delete · delete_tag

• Lists your habits

  Returns all your habits.

  Try: “What habits am I tracking?”

  Network · list_habits

• Shows the details of one habit

  Returns a habit's settings and details.

  Try: “Show me my reading habit”

  Network · get_habit

• Shows your check-ins for a habit

  Returns the check-in history for a habit.

  Try: “How many days did I meditate this month?”

  Network · get_habit_checkins

• Logs or fixes habit check-ins

  Adds or corrects check-ins for a habit, for any day in the past 90 days.

  Try: “Check in my running habit for yesterday”

  Write · upsert_habit_checkins

• Creates a new habit

  Creates a new habit to track.

  Try: “Create a habit to drink 8 glasses of water a day”

  Write · create_habit

• Changes a habit's settings

  Updates a habit's settings, such as its goal or schedule.

  Try: “Change my reading habit to 20 minutes a day”

  Write · update_habit

• Lists your habit sections

  Returns the sections your habits are grouped into.

  Try: “What habit sections do I have?”

  Network · list_habit_sections

• Shows your focus sessions for a time range

  Returns your focus or Pomodoro records for a range of up to one month.

  Try: “How much did I focus last week?”

  Network · get_focuses_by_time

• Shows one focus session

  Returns the details of a single focus record.

  Try: “Show my focus session from this morning”

  Network · get_focus

• Logs a focus session

  Adds a focus record.

  Try: “Log a 45 minute focus session on the report”

  Write · create_focus

• Edits a focus session, except its length

  Updates a focus record; its duration cannot be changed.

  Try: “Attach my morning focus session to the report task”

  Write · update_focus

• Deletes a focus session

  Deletes a focus record.

  Try: “Delete the focus session I logged by mistake”

  Delete · delete_focus

• Shows events from calendars linked to TickTick

  Looks up events from third-party calendars connected to TickTick, up to three months at a time.

  Try: “What meetings do I have next week?”

  Network · query_calendar_events

• Lists the calendars linked to TickTick

  Returns the third-party calendar accounts connected to TickTick.

  Try: “Which calendars are linked to my TickTick?”

  Network · list_calendar_accounts

• Lists your countdowns

  Returns all your countdowns.

  Try: “How many days until my holiday?”

  Network · list_countdowns

• Used by the assistant behind the scenes

  Listed on the Claude connector with no description

  TickTick lists this on its Claude connector but does not say what it does.

  Network · get_user_preference

• Listed on the Claude connector with no description

  TickTick lists this on its Claude connector but does not say what it does.

  Network · search

• Listed on the Claude connector with no description

  TickTick lists this on its Claude connector but does not say what it does.

  Network · fetch

Watch out for

• It can delete tags, comments and focus records

  Deleted tasks go to Trash, but deleting a tag removes it from every task. Ask it to confirm before deleting anything. help.ticktick.com

• An API token reaches your whole account

  Token setups save the token in a config file or command. Use sign-in where your app offers it, and keep config files out of shared folders. help.ticktick.com

• It can pick the wrong task

  TickTick notes the AI may misread a request. Name the exact list and date, and ask it to find the task before changing it. help.ticktick.com

• It can read your connected calendars

  It can look up events from calendars you have linked to TickTick. help.ticktick.com

Security advisories