TickTick is a cross-platform task management and to-do list application designed to help users organize their tasks and schedules efficiently.
TickTick is a cross-platform task management and to-do list application designed to help users organize their tasks and schedules efficiently. On Nagent, Ticktick is exposed as a fully-configurable productivity integration that any agent can call — 14 actions, and OAuth authentication. No code is required to wire Ticktick into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Ticktick to automate the kinds of tasks productivity teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Ticktick into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Ticktick, with input parameters and output schema. Drop these into any step of an agent built in Helix.
TICKTICK_COMPLETE_TASKMarks a TickTick task as complete. Requires both the project_id and task_id, which can be obtained from TICKTICK_LIST_ALL_TASKS or TICKTICK_CREATE_TASK actions. This action is idempotent - completing an already-completed task will succeed without error. Completed tasks are removed from default/active views and appear only in completed task filters.
Input parameters
Identifier of the task to mark as complete.
Project identifier containing the task to complete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_CREATE_PROJECTCreate a new project (list) in TickTick. Projects organize tasks and notes. Use this to set up a new project with optional customizations like color, view mode, and type. The created project's ID can be used with other actions like TICKTICK_CREATE_TASK.
Input parameters
Type of project: 'TASK' for task management or 'NOTE' for note-taking. Defaults to 'TASK' if not specified.
Name of the new project. This will be displayed in the TickTick interface.
Hex color code for the project appearance (e.g., '#F18181'). Must include the '#' prefix.
Display mode for the project: 'list' for standard view, 'kanban' for board view, or 'timeline' for calendar view. Defaults to 'list' if not specified.
Sort order value for positioning the project in lists. Can be negative, zero, or positive. Lower values appear first.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_CREATE_TASKTool to create a new task in TickTick. Use after you have task details such as title, dates, and optional reminders or subtasks.
Input parameters
Extended description of the task
Checklist (subtask) items
Title of the task
Main content or notes of the task
ISO 8601 due date/time, e.g., '2023-04-24T17:00:00+0000'
Set true for an all-day task
Task priority (0=None, 1=Low, 3=Medium, 5=High)
Time zone identifier, e.g., 'America/Los_Angeles'
ID of the project (list) to add the task to. If omitted, the task is added to the Inbox. Use TICKTICK_GET_USER_PROJECT to get available project IDs. The Inbox does not appear in TICKTICK_GET_USER_PROJECT results; simply omit this field to target it.
List of reminder triggers in RFC 5545 format, e.g., \['TRIGGER:PT10M', 'TRIGGER:PT0S'\] Malformed strings may be silently ignored rather than raising an error.
Internal sort index
ISO 8601 start date/time, e.g., '2023-04-23T12:00:00+0000'
RRULE string for recurrence, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_CREATE_TASK2DEPRECATED: Use TICKTICK_CREATE_TASK instead. Tool to create a new task in a specified project. Use when you need to create a task with required title and projectId, plus optional dates, priority, reminders, and subtasks.
Input parameters
Description of the task or checklist
The list of subtasks (checklist items) for this task
Title of the task
Task content or notes
Due date and time in yyyy-MM-ddTHH:mm:ssZ format
Set true for an all-day task
The priority of task: 0=None, 1=Low, 3=Medium, 5=High. Default is 0.
The time zone in which the time is specified, e.g., 'America/Los_Angeles'
ID of the project (list) to add the task to. Use TICKTICK_GET_USER_PROJECT to get available project IDs.
Lists of reminders specific to the task in RFC 5545 format, e.g., \['TRIGGER:PT10M'\]
The order of task for sorting purposes
Start date and time in yyyy-MM-ddTHH:mm:ssZ format
Recurring rules of task in RRULE format, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_DELETE_PROJECTPermanently deletes a TickTick project by its ID. All tasks within the project will also be deleted. Note: This operation is idempotent - deleting a non-existent project ID returns success. Use TICKTICK_GET_USER_PROJECT to list available projects and their IDs before deletion.
Input parameters
The unique identifier of the TickTick project to delete. Obtain this from TICKTICK_GET_USER_PROJECT or TICKTICK_CREATE_PROJECT actions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_DELETE_TASKTool to permanently delete a specific task — irreversible, no recovery. Use when you need to remove a task from a project after confirming both project and task IDs. Returns an empty data object on success; check status/success flags rather than response payload. When moving tasks between projects via create+delete, comments and history are lost.
Input parameters
Task identifier to delete.
Project identifier containing the task to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_GET_PROJECT_BY_IDTool to retrieve a specific TickTick project by its unique ID. Use when you need detailed information about a particular project after obtaining its project ID.
Input parameters
The unique ID of the project to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_GET_PROJECT_WITH_DATARetrieve a project's associated data (incomplete tasks, columns). IMPORTANT: This endpoint only returns INCOMPLETE tasks. Completed tasks are automatically filtered out by the TickTick API. An empty tasks list means either the project has no tasks at all, or all tasks have been completed. For completed tasks, check the TickTick app or web interface directly. Columns are only present for kanban-style projects; list-view projects return an empty columns array. Join tasks to columns via each task's columnId field. For large projects, results may paginate at ~100 items per page — iterate all pages and deduplicate by taskId. Multiple tasks can share the same title; always use taskId for follow-up create, update, or delete calls. All filtering by name, tag, or other fields must be done client-side. Scope is project-only — Inbox and other projects are excluded.
Input parameters
Project identifier to retrieve data for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_GET_TASK_BY_PROJECT_AND_IDTool to retrieve a specific TickTick task by project ID and task ID. Use when you need detailed information about a particular task within a project.
Input parameters
The unique ID of the specific task to retrieve
The unique ID of the project containing the task
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_GET_USER_PROJECTRetrieves all projects accessible to the authenticated user, including personal and shared projects. Use this tool to list available projects before creating tasks or to get project IDs for other operations. Returns project metadata including name, color, view mode, and organization details. Always use returned projectId values (not project names) when calling TICKTICK_CREATE_TASK, TICKTICK_UPDATE_TASK, or TICKTICK_GET_PROJECT_WITH_DATA. The inbox project may not appear in results — omit projectId in TICKTICK_CREATE_TASK to target the inbox. Non-kanban projects return an empty columns array; check viewMode before assuming columns exist.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_LIST_ALL_TASKSTool to list all open/undone tasks across all user projects in one call. This is a composite operation that internally fetches all projects and aggregates their tasks. Use when you need a comprehensive view of pending work across the entire account. Note: Only returns open/undone tasks; completed task history is not available in TickTick OpenAPI v1.
Input parameters
Optional maximum number of tasks to return. Applied after aggregating all tasks.
Optional list of specific project IDs to include. If omitted, all projects are included.
Whether to include tasks from closed/archived projects. Defaults to False.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_OAUTH2_AUTHORIZATION_STEP1Tool to generate the TickTick OAuth2 authorization URL. Use to redirect the user to obtain the authorization code (step 1). Re-run this tool if downstream TickTick calls return HTTP 401 (expired/invalid token) to obtain a fresh authorization code.
Input parameters
Space-separated permission scopes. Available scopes: 'tasks:read', 'tasks:write'. If a downstream call returns HTTP 403 insufficient_scope, re-run this tool with the correct scopes.
An opaque value passed back to your redirect URI for CSRF protection and to maintain request state (optional).
Your TickTick application's client ID obtained from the Developer Center.
The exact redirect URI registered with your TickTick application; the authorization code will be sent here after user approval.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_UPDATE_PROJECTTool to update an existing project. Use when you need to modify project details like name, color, sort order, view mode, or kind after selecting a project ID.
Input parameters
Kind of the project, 'TASK' or 'NOTE'
New name of the project
Hex color code for the project, e.g. '#F18181'
View mode for the project
The unique project ID (24-character hex string) to update. Obtain this from TICKTICK_GET_USER_PROJECT or TICKTICK_CREATE_PROJECT.
Sort order value for positioning the project in lists. Can be negative, zero, or positive. Lower values appear first.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TICKTICK_UPDATE_TASKTool to update an existing task. Use after confirming the taskId and projectId. Omitting optional fields resets them to null — include all existing field values in every payload. Cannot move a task to a different project; use TICKTICK_CREATE_TASK + TICKTICK_DELETE_TASK instead. Fields outside the input schema (e.g., columnId, assignee) are silently ignored.
Input parameters
Extended description of the task
Checklist (subtask) items
New title of the task
Task identifier to update
Content or notes of the task
ISO 8601 due date/time, e.g., '2023-04-24T17:00:00+0000'
Set true for an all-day task
Task priority (0=None, 1=Low, 3=Medium, 5=High) Only 0, 1, 3, 5 are valid; other integers are rejected.
Time zone identifier, e.g., 'America/Los_Angeles'
Project identifier containing the task
List of reminder triggers in RFC 5545 format, e.g., \['TRIGGER:PT10M'\]
Internal sort index for ordering tasks
ISO 8601 start date/time, e.g., '2023-04-23T12:00:00+0000'
RRULE string for recurrence, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 34 agents privately built on Nagent that already use Ticktick.
Build on Nagent
Connect Ticktick to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Ticktick, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Ticktick is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Ticktick is connected, you configure its 14 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Ticktick steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Ticktick event fires, the agent kicks off automatically.
Every Ticktick action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Ticktick ships with 14 pre-built productivity actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Ticktick together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Ticktick-based workflows tailored to your business.