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 Server offers a comprehensive set of tools for managing tasks and within Ticktick. 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 , or create your own tools.
TicktickApi.RetrieveTaskDetails
Retrieve detailed information for a specific task.
Parameters
- project_identifier (
string, required) The unique ID of the 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 and task IDs.
Parameters
- project_id (
string, required) The unique ID of the containing the task to be deleted. - task_identifier_to_delete (
string, required) The unique ID of the task to permanently delete from a .
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 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 from Ticktick.
Parameters
This does not take any parameters.
TicktickApi.CreateProjectInTicktick
Create a new in Ticktick with optional properties.
Parameters
- project_name (
string, required) Name of the to be created. This is a required field. - project_color (
string, optional) Hex color code representing the ’s color (e.g., ‘#F18181’). - project_kind (
string, optional) Specifies the type of items the will store. Choose ‘TASK’ for tasks or ‘NOTE’ for notes. - project_sort_order (
integer, optional) The integer value representing the ’s sort order. - project_view_mode (
string, optional) The display mode for the : choose from ‘list’, ‘kanban’, or ‘timeline’.
TicktickApi.GetTicktickProjectById
Retrieve Ticktick details by project ID.
Parameters
- project_id (
string, required) The unique ID of the Ticktick to retrieve.
TicktickApi.UpdateProjectProperties
Update properties of an existing .
Parameters
- project_identifier (
string, required) Unique ID of the to update. - project_color (
string, optional) Hex color code representing the color of the , such as ‘#FFFFFF’. - project_kind (
string, optional) Specify the type of : TASK or NOTE. - project_name (
string, optional) The new name for the to be updated. This should be a string representing the desired project name. - project_sort_order (
integer, optional) Sort order value for the , default is 0. Determines the project’s position relative to others. - project_view_mode (
string, optional) Specifies the view mode of the . Options are ‘list’, ‘kanban’, or ‘timeline’.
TicktickApi.DeleteTicktickProject
Permanently delete a in Ticktick by ID.
Parameters
- project_id (
string, required) The unique ID of the Ticktick to permanently delete. Ensure the ID is correct, as this action cannot be undone.
TicktickApi.RetrieveProjectWithTasks
Retrieve detailed information and all related tasks.
Parameters
- project_id (
string, required) The unique ID of the 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 Server:
ToolMode
- GET_REQUEST_SCHEMA:
get_request_schema - EXECUTE:
execute
Auth
The TicktickApi Server uses the with id arcade-ticktick to connect to users’ TickTick accounts. In order to use the , you will need to configure the arcade-ticktick auth provider.
Learn how to configure the TickTick in the TickTick auth provider documentation.