NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Ticktick connects to a Nagent workspace with OAuth sign-in. Once it is connected, agents can call 14 Ticktick actions, such as "Create Project", "Create Task" and "Create Task (Deprecated)". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Ticktick, with input parameters and output schema.
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
Agents can call 14 Ticktick actions on Nagent, including "Create Project", "Create Task" and "Create Task (Deprecated)". Create Project: Create a new project (list) in TickTick. Each action is listed on this page with its input parameters and its output.
Ticktick connects with OAuth sign-in, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Project takes 1 required input: name. It also takes 4 optional inputs: kind, color, viewMode and sortOrder. It returns data, error and successful.