TickTick API

The TickTick toolkit connects LLMs to the TickTick task-management API via Arcade, enabling full programmatic control over projects and tasks in a user's TickTick account.

Capabilities

Project management — create, retrieve (by ID or full list), update properties (name, color, sort order, view mode, kind), and permanently delete projects.
Task lifecycle — create richly configured tasks (title, content, dates, reminders, subtasks, project assignment), retrieve task details, update any task property, mark tasks complete, and permanently delete tasks.
Project + task views — fetch a complete project snapshot including all associated tasks and column configurations in a single call.
Schema-guided operations — CreateTaskTicktick and UpdateTaskProperties expose a GET_REQUEST_SCHEMA mode so the LLM can inspect the expected JSON structure before executing, avoiding blind request construction.

OAuth

This toolkit uses OAuth 2.0 to authenticate with TickTick on behalf of the user. See the Arcade TickTick auth provider docs for configuration details.

	Tool name	Description	Secrets
	TicktickApi.CreateProjectInTicktick	Create a new project in Ticktick with optional properties. Use this tool to create a new project in Ticktick. You can specify the project's name and other optional properties such as color, sort order, view mode, and kind (TASK or NOTE).
	TicktickApi.CreateTaskTicktick	Create a new task in Ticktick with specified properties. Use this tool to create a new task in Ticktick by specifying title, content, dates, reminders, subtasks, and the project it belongs to. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. If you need the schema, call with mode='get_request_schema' ONCE, then execute.
	TicktickApi.DeleteSpecificTask	Permanently delete a task using project and task IDs. This tool is used to permanently remove a specific task by providing its project ID and task ID from Ticktick. Use this when you need to delete a task and ensure it is no longer available in the project.
	TicktickApi.DeleteTicktickProject	Permanently delete a project in Ticktick by ID. Use this tool to permanently remove a specific project and all associated tasks from Ticktick by providing the project's ID. Ensure you no longer need the project, as this action cannot be undone.
	TicktickApi.GetTicktickProjectById	Retrieve Ticktick project details by project ID. This tool retrieves detailed information about a specific project in Ticktick using its ID. It provides the project's name, color, view mode, and kind.
	TicktickApi.GetUserProjects	Retrieve all user-accessible projects from Ticktick. This tool fetches a list of all projects that the authenticated user has access to in Ticktick. It should be called when a user wants to view or manage their projects within the platform.
	TicktickApi.MarkTaskComplete	Marks a specific task as completed in Ticktick. Use this tool to mark a task as completed in Ticktick, updating its status and setting the completion time.
	TicktickApi.RetrieveProjectWithTasks	Retrieve detailed project information and all related tasks. Call this tool to get a complete view of a project, including tasks and column configurations, especially useful for understanding project status and organization.
	TicktickApi.RetrieveTaskDetails	Retrieve detailed information for a specific task. Use this tool to get detailed information about a task by providing the project ID and task ID. It returns information including subtasks, reminders, and scheduling details.
	TicktickApi.UpdateProjectProperties	Update properties of an existing project. This tool updates various properties of an existing project, such as name, color, sort order, view mode, and kind. It should be used when changes to these attributes are needed for a project on Ticktick.
	TicktickApi.UpdateTaskProperties	Update a task's properties in Ticktick. Use this tool to update various properties of a task in Ticktick. It requires the task ID and project ID, while other fields are optional. Ideal for modifying task details such as status, title, or due date. Note: Understanding the request schema is necessary to properly create the stringified JSON input object for execution. This operation also requires path parameters. Modes: - GET_REQUEST_SCHEMA: Returns the schema. Only call if you don't already have it. Do NOT call repeatedly if you already received the schema. - EXECUTE: Performs the operation with the provided request body JSON. Note: You must also provide the required path parameters when executing. If you need the schema, call with mode='get_request_schema' ONCE, then execute.

Capabilities

OAuth

Available tools(11)

Get Building