TicktickApi
Description: Tools that enable LLMs to interact directly with the ticktick API.
Author: Arcade
Auth: User authorization
TicktickApi is a Starter MCP Server: each tool mirrors one HTTP endpoint and offers LLMs a way to interact with the low-level API.
Differently from Optimized MCP Servers, Starter tools are heavily influenced by the original API design, which is not usually optimized for LLM usage. For this reason, we recommend thoroughly evaluating the tools with your Agents or chatbots before using it in production. Read more about Optimized vs Starter tools.
The TicktickApi MCP Server offers a comprehensive set of tools for managing tasks and projects within Ticktick. Users can easily create, update, and delete tasks and projects, as well as retrieve detailed information about them. Key actions include:
Available Tools
| Tool Name | Description |
|---|---|
| TicktickApi.RetrieveTaskDetails | Retrieve detailed information for a specific task. |
| TicktickApi.DeleteSpecificTask | Permanently delete a task using project and task IDs. |
| TicktickApi.CreateTaskTicktick | Create a new task in Ticktick with specified properties. |
| TicktickApi.UpdateTaskProperties | Update a task's properties in Ticktick. |
| TicktickApi.MarkTaskComplete | Marks a specific task as completed in Ticktick. |
| TicktickApi.GetUserProjects | Retrieve all user-accessible projects from Ticktick. |
| TicktickApi.CreateProjectInTicktick | Create a new project in Ticktick with optional properties. |
| TicktickApi.GetTicktickProjectById | Retrieve Ticktick project details by project ID. |
| TicktickApi.UpdateProjectProperties | Update properties of an existing project. |
| TicktickApi.DeleteTicktickProject | Permanently delete a project in Ticktick by ID. |
| TicktickApi.RetrieveProjectWithTasks | Retrieve detailed project information and all related tasks. |
If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools.
TicktickApi.RetrieveTaskDetails
Retrieve detailed information for a specific task.
Parameters
- project_identifier (
string, required) The unique ID of the project containing the task to retrieve. - task_identifier (
string, required) Unique identifier for the task to retrieve detailed information including subtasks and reminders.
TicktickApi.DeleteSpecificTask
Permanently delete a task using project and task IDs.
Parameters
- project_id (
string, required) The unique ID of the project containing the task to be deleted. - task_identifier_to_delete (
string, required) The unique ID of the task to permanently delete from a project.
TicktickApi.CreateTaskTicktick
Create a new task in Ticktick with specified properties.
Parameters
- mode (
EnumToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation - request_body (
string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’
TicktickApi.UpdateTaskProperties
Update a task’s properties in Ticktick.
Parameters
- mode (
EnumToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation - task_identifier (
string, optional) The unique ID of the task to update in Ticktick. This is required to identify the specific task to be updated. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’. - request_body (
string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’
TicktickApi.MarkTaskComplete
Marks a specific task as completed in Ticktick.
Parameters
- project_id (
string, required) Unique ID of the project containing the task to be completed. - task_identifier (
string, required) The unique ID of the task to be marked as completed.
TicktickApi.GetUserProjects
Retrieve all user-accessible projects from Ticktick.
Parameters
This tool does not take any parameters.
TicktickApi.CreateProjectInTicktick
Create a new project in Ticktick with optional properties.
Parameters
- project_name (
string, required) Name of the project to be created. This is a required field. - project_color (
string, optional) Hex color code representing the project’s color (e.g., ‘#F18181’). - project_kind (
string, optional) Specifies the type of items the project will store. Choose ‘TASK’ for tasks or ‘NOTE’ for notes. - project_sort_order (
integer, optional) The integer value representing the project’s sort order. - project_view_mode (
string, optional) The display mode for the project: choose from ‘list’, ‘kanban’, or ‘timeline’.
TicktickApi.GetTicktickProjectById
Retrieve Ticktick project details by project ID.
Parameters
- project_id (
string, required) The unique ID of the Ticktick project to retrieve.
TicktickApi.UpdateProjectProperties
Update properties of an existing project.
Parameters
- project_identifier (
string, required) Unique ID of the project to update. - project_color (
string, optional) Hex color code representing the color of the project, such as ‘#FFFFFF’. - project_kind (
string, optional) Specify the type of project: TASK or NOTE. - project_name (
string, optional) The new name for the project to be updated. This should be a string representing the desired project name. - project_sort_order (
integer, optional) Sort order value for the project, default is 0. Determines the project’s position relative to others. - project_view_mode (
string, optional) Specifies the view mode of the project. Options are ‘list’, ‘kanban’, or ‘timeline’.
TicktickApi.DeleteTicktickProject
Permanently delete a project in Ticktick by ID.
Parameters
- project_id (
string, required) The unique ID of the Ticktick project to permanently delete. Ensure the ID is correct, as this action cannot be undone.
TicktickApi.RetrieveProjectWithTasks
Retrieve detailed project information and all related tasks.
Parameters
- project_id (
string, required) The unique ID of the project to retrieve with all data, including tasks and columns.
Reference
Below is a reference of enumerations used by some of the tools in the TicktickApi MCP Server:
ToolMode
- GET_REQUEST_SCHEMA:
get_request_schema - EXECUTE:
execute
Auth
The TicktickApi MCP Server uses the Auth Provider with id arcade-ticktick to connect to users’ TickTick accounts. In order to use the MCP Server, you will need to configure the arcade-ticktick auth provider.
Learn how to configure the TickTick auth provider in the TickTick auth provider documentation.