Skip to main content
Ticktick logo
  • Category: productivity
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 23
  • Triggers: 0
  • Slug: TICKTICK
  • Version: 20261101_00

Tools

Slug: TICKTICK_ADD_TASK_COMMENTAdd a discussion comment to a task in a TickTick project.

Input Parameters

string
required
Comment text.
string
required
Task to comment on.
string
required
Project containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_BATCH_CREATE_OR_UPDATE_TASKSCreate and update up to 50 TickTick tasks per operation in one request.

Input Parameters

array
Tasks to create, maximum 50
array
Tasks to update, maximum 50

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_COMPLETE_TASKMark a TickTick task as complete using its project ID and task ID.

Input Parameters

string
required
Identifier of the task to mark as complete.
string
required
Project identifier containing the task to complete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_CREATE_COLUMNCreate a named column in an existing TickTick project.

Input Parameters

string
required
Column name, up to 1000 characters.
string
required
Identifier of the project in which to create the column.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string ("TASK" | "NOTE")
Type of project: ‘TASK’ for task management or ‘NOTE’ for note-taking. Defaults to ‘TASK’ if not specified.
string
required
Name of the new project. This will be displayed in the TickTick interface.
string
Hex color code for the project appearance (e.g., ‘#F18181’). Must include the ’#’ prefix.
string ("list" | "kanban" | "timeline")
Display mode for the project: ‘list’ for standard view, ‘kanban’ for board view, or ‘timeline’ for calendar view. Defaults to ‘list’ if not specified.
integer
Sort order value for positioning the project in lists. Can be negative, zero, or positive. Lower values appear first.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Extended description of the task
array
Checklist (subtask) items
string
required
Title of the task
string
Main content or notes of the task
string
ISO 8601 due date/time, e.g., ‘2023-04-24T17:00:00+0000’
boolean
Set true for an all-day task
integer
Task priority (0=None, 1=Low, 3=Medium, 5=High)
string
Time zone identifier, e.g., ‘America/Los_Angeles’
string
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.
array
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.
integer
Internal sort index
string
ISO 8601 start date/time, e.g., ‘2023-04-23T12:00:00+0000’
string
RRULE string for recurrence, e.g., ‘RRULE:FREQ=DAILY;INTERVAL=1’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Description of the task or checklist
array
The list of subtasks (checklist items) for this task
string
required
Title of the task
string
Task content or notes
string
Due date and time in yyyy-MM-ddTHH:mm:ssZ format
boolean
Set true for an all-day task
integer
The priority of task: 0=None, 1=Low, 3=Medium, 5=High. Default is 0.
string
The time zone in which the time is specified, e.g., ‘America/Los_Angeles’
string
required
ID of the project (list) to add the task to. Use TICKTICK_GET_USER_PROJECT to get available project IDs.
array
Lists of reminders specific to the task in RFC 5545 format, e.g., [‘TRIGGER:PT10M’]
integer
The order of task for sorting purposes
string
Start date and time in yyyy-MM-ddTHH:mm:ssZ format
string
Recurring rules of task in RRULE format, e.g., ‘RRULE:FREQ=DAILY;INTERVAL=1’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The unique identifier of the TickTick project to delete. Obtain this from TICKTICK_GET_USER_PROJECT or TICKTICK_CREATE_PROJECT actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Task identifier to delete.
string
required
Project identifier containing the task to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_FILTER_TASKSReturn up to 200 tasks matching project, start-date, priority, tag, kind, and status filters. Tasks must contain all specified tags.

Input Parameters

array
Tag names tasks must match.
array
Task kinds to include.
array
Statuses to include: -1 abandoned, 0 normal, or 2 completed.
string
Include tasks whose startDate is on or before this ISO 8601 timestamp.
array
Priorities to include: 0 none, 1 low, 3 medium, or 5 high.
string
Include tasks whose startDate is on or after this ISO 8601 timestamp.
array
Project IDs whose tasks should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The unique ID of the project to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_GET_PROJECT_WITH_DATARetrieve a TickTick project’s metadata, undone tasks, and columns by project ID. Completed tasks are excluded; filtering the returned data must be done client-side.

Input Parameters

string
required
Project identifier to retrieve data for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The unique ID of the specific task to retrieve
string
required
The unique ID of the project containing the task

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_GET_USER_PROJECTRetrieves projects accessible to the authenticated user, including their IDs and metadata such as name, color, view mode, and organization details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_LIST_ALL_TASKSList open tasks across TickTick projects, with project context. Optionally select project IDs, include closed projects, and limit the aggregated results. Projects returning a non-200 response or unreadable data are skipped, so results may be incomplete; the returned total reflects the applied limit.

Input Parameters

integer
Optional maximum number of tasks to return. Applied after aggregating all tasks.
array
Optional list of specific project IDs to include. If omitted, all projects are included.
boolean
Whether to include tasks from closed/archived projects. Defaults to False.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_LIST_COMPLETED_TASKSReturn up to 200 completed tasks, optionally filtered by project and completion date.

Input Parameters

string
Inclusive upper bound for completedTime in ISO 8601 format
string
Inclusive lower bound for completedTime in ISO 8601 format
array
Project IDs whose completed tasks should be returned

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_LIST_PROJECT_MEMBERSList the users who belong to a TickTick project.

Input Parameters

string
required
Project whose members to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_LIST_TAGSList the tags available to the connected TickTick account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_LIST_TASK_COMMENTSList discussion comments attached to a task in a TickTick project.

Input Parameters

string
required
Task whose comments to retrieve.
string
required
Project containing the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_MOVE_TASKSMove one or more existing tasks between TickTick projects.

Input Parameters

array
required
One or more task moves to perform in a single request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
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.
string
An opaque value passed back to your redirect URI for CSRF protection and to maintain request state (optional).
string
required
Your TickTick application’s client ID obtained from the Developer Center.
string
required
The exact redirect URI registered with your TickTick application; the authorization code will be sent here after user approval.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string ("TASK" | "NOTE")
Kind of the project, ‘TASK’ or ‘NOTE’
string
New name of the project
string
Hex color code for the project, e.g. ‘#F18181’
string ("list" | "kanban" | "timeline")
View mode for the project
string
required
The unique project ID (24-character hex string) to update. Obtain this from TICKTICK_GET_USER_PROJECT or TICKTICK_CREATE_PROJECT.
integer
Sort order value for positioning the project in lists. Can be negative, zero, or positive. Lower values appear first.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TICKTICK_UPDATE_TASKUpdates an existing TickTick task identified by task ID and project ID, with optional task details such as dates, reminders, recurrence, priority, and checklist items.

Input Parameters

string
Extended description of the task
array
Checklist (subtask) items
string
New title of the task
string
required
Task identifier to update
string
Content or notes of the task
string
ISO 8601 due date/time, e.g., ‘2023-04-24T17:00:00+0000’
boolean
Set true for an all-day task
integer
Task priority (0=None, 1=Low, 3=Medium, 5=High) Only 0, 1, 3, 5 are valid; other integers are rejected.
string
Time zone identifier, e.g., ‘America/Los_Angeles’
string
required
Project identifier containing the task
array
List of reminder triggers in RFC 5545 format, e.g., [‘TRIGGER:PT10M’]
integer
Internal sort index for ordering tasks
string
ISO 8601 start date/time, e.g., ‘2023-04-23T12:00:00+0000’
string
RRULE string for recurrence, e.g., ‘RRULE:FREQ=DAILY;INTERVAL=1’

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not