> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticktick

> TickTick is a cross-platform task management and to-do list application designed to help users organize their tasks and schedules efficiently.

![Ticktick logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/ticktick.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=373632ad096352b0b72a237f014ff9b0)

* **Category:** productivity
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 23
* **Triggers:** 0
* **Slug:** `TICKTICK`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Task Comment
>
> **Slug:** `TICKTICK_ADD_TASK_COMMENT`
>
> Add a discussion comment to a task in a TickTick project.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Comment text.
>
> **task\_id** `string` *required*
>
> Task to comment on.
>
> **project\_id** `string` *required*
>
> Project containing the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Create Or Update Tasks
>
> **Slug:** `TICKTICK_BATCH_CREATE_OR_UPDATE_TASKS`
>
> Create and update up to 50 TickTick tasks per operation in one request.
>
> #### Input Parameters
>
> **add** `array`
>
> Tasks to create, maximum 50
>
> **update** `array`
>
> Tasks to update, maximum 50
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Complete Task
>
> **Slug:** `TICKTICK_COMPLETE_TASK`
>
> Mark a TickTick task as complete using its project ID and task ID.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Identifier of the task to mark as complete.
>
> **project\_id** `string` *required*
>
> Project identifier containing the task to complete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Column
>
> **Slug:** `TICKTICK_CREATE_COLUMN`
>
> Create a named column in an existing TickTick project.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Column name, up to 1000 characters.
>
> **project\_id** `string` *required*
>
> Identifier of the project in which to create the column.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Project
>
> **Slug:** `TICKTICK_CREATE_PROJECT`
>
> Create 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
>
> **kind** `string ("TASK" | "NOTE")`
>
> Type of project: 'TASK' for task management or 'NOTE' for note-taking. Defaults to 'TASK' if not specified.
>
> **name** `string` *required*
>
> Name of the new project. This will be displayed in the TickTick interface.
>
> **color** `string`
>
> Hex color code for the project appearance (e.g., '#F18181'). Must include the '#' prefix.
>
> **viewMode** `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.
>
> **sortOrder** `integer`
>
> Sort order value for positioning the project in lists. Can be negative, zero, or positive. Lower values appear first.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Task
>
> **Slug:** `TICKTICK_CREATE_TASK`
>
> Tool to create a new task in TickTick. Use after you have task details such as title, dates, and optional reminders or subtasks.
>
> #### Input Parameters
>
> **desc** `string`
>
> Extended description of the task
>
> **items** `array`
>
> Checklist (subtask) items
>
> **title** `string` *required*
>
> Title of the task
>
> **content** `string`
>
> Main content or notes of the task
>
> **dueDate** `string`
>
> ISO 8601 due date/time, e.g., '2023-04-24T17:00:00+0000'
>
> **isAllDay** `boolean`
>
> Set true for an all-day task
>
> **priority** `integer`
>
> Task priority (0=None, 1=Low, 3=Medium, 5=High)
>
> **timeZone** `string`
>
> Time zone identifier, e.g., 'America/Los\_Angeles'
>
> **projectId** `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.
>
> **reminders** `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.
>
> **sortOrder** `integer`
>
> Internal sort index
>
> **startDate** `string`
>
> ISO 8601 start date/time, e.g., '2023-04-23T12:00:00+0000'
>
> **repeatFlag** `string`
>
> RRULE string for recurrence, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Task (Deprecated)
>
> **Slug:** `TICKTICK_CREATE_TASK2`
>
> DEPRECATED: 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
>
> **desc** `string`
>
> Description of the task or checklist
>
> **items** `array`
>
> The list of subtasks (checklist items) for this task
>
> **title** `string` *required*
>
> Title of the task
>
> **content** `string`
>
> Task content or notes
>
> **dueDate** `string`
>
> Due date and time in yyyy-MM-ddTHH:mm:ssZ format
>
> **isAllDay** `boolean`
>
> Set true for an all-day task
>
> **priority** `integer`
>
> The priority of task: 0=None, 1=Low, 3=Medium, 5=High. Default is 0.
>
> **timeZone** `string`
>
> The time zone in which the time is specified, e.g., 'America/Los\_Angeles'
>
> **projectId** `string` *required*
>
> ID of the project (list) to add the task to. Use TICKTICK\_GET\_USER\_PROJECT to get available project IDs.
>
> **reminders** `array`
>
> Lists of reminders specific to the task in RFC 5545 format, e.g., \['TRIGGER:PT10M']
>
> **sortOrder** `integer`
>
> The order of task for sorting purposes
>
> **startDate** `string`
>
> Start date and time in yyyy-MM-ddTHH:mm:ssZ format
>
> **repeatFlag** `string`
>
> Recurring rules of task in RRULE format, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete TickTick Project
>
> **Slug:** `TICKTICK_DELETE_PROJECT`
>
> Permanently 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
>
> **project\_id** `string` *required*
>
> The unique identifier of the TickTick project to delete. Obtain this from TICKTICK\_GET\_USER\_PROJECT or TICKTICK\_CREATE\_PROJECT actions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Task
>
> **Slug:** `TICKTICK_DELETE_TASK`
>
> Tool 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\_id** `string` *required*
>
> Task identifier to delete.
>
> **project\_id** `string` *required*
>
> Project identifier containing the task to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Filter Tasks
>
> **Slug:** `TICKTICK_FILTER_TASKS`
>
> Return up to 200 tasks matching project, start-date, priority, tag, kind, and status filters. Tasks must contain all specified tags.
>
> #### Input Parameters
>
> **tag** `array`
>
> Tag names tasks must match.
>
> **kind** `array`
>
> Task kinds to include.
>
> **status** `array`
>
> Statuses to include: -1 abandoned, 0 normal, or 2 completed.
>
> **endDate** `string`
>
> Include tasks whose startDate is on or before this ISO 8601 timestamp.
>
> **priority** `array`
>
> Priorities to include: 0 none, 1 low, 3 medium, or 5 high.
>
> **startDate** `string`
>
> Include tasks whose startDate is on or after this ISO 8601 timestamp.
>
> **projectIds** `array`
>
> Project IDs whose tasks should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project By ID
>
> **Slug:** `TICKTICK_GET_PROJECT_BY_ID`
>
> Tool 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
>
> **projectId** `string` *required*
>
> The unique ID of the project to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project with data
>
> **Slug:** `TICKTICK_GET_PROJECT_WITH_DATA`
>
> Retrieve 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
>
> **projectId** `string` *required*
>
> Project identifier to retrieve data for
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task By Project And ID
>
> **Slug:** `TICKTICK_GET_TASK_BY_PROJECT_AND_ID`
>
> Tool 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
>
> **task\_id** `string` *required*
>
> The unique ID of the specific task to retrieve
>
> **project\_id** `string` *required*
>
> The unique ID of the project containing the task
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Projects
>
> **Slug:** `TICKTICK_GET_USER_PROJECT`
>
> Retrieves projects accessible to the authenticated user, including their IDs and metadata such as name, color, view mode, and organization details.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List All Tasks
>
> **Slug:** `TICKTICK_LIST_ALL_TASKS`
>
> List 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
>
> **limit** `integer`
>
> Optional maximum number of tasks to return. Applied after aggregating all tasks.
>
> **projectIds** `array`
>
> Optional list of specific project IDs to include. If omitted, all projects are included.
>
> **includeClosedProjects** `boolean`
>
> Whether to include tasks from closed/archived projects. Defaults to False.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Completed Tasks
>
> **Slug:** `TICKTICK_LIST_COMPLETED_TASKS`
>
> Return up to 200 completed tasks, optionally filtered by project and completion date.
>
> #### Input Parameters
>
> **endDate** `string`
>
> Inclusive upper bound for completedTime in ISO 8601 format
>
> **startDate** `string`
>
> Inclusive lower bound for completedTime in ISO 8601 format
>
> **projectIds** `array`
>
> Project IDs whose completed tasks should be returned
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Project Members
>
> **Slug:** `TICKTICK_LIST_PROJECT_MEMBERS`
>
> List the users who belong to a TickTick project.
>
> #### Input Parameters
>
> **project\_id** `string` *required*
>
> Project whose members to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tags
>
> **Slug:** `TICKTICK_LIST_TAGS`
>
> List the tags available to the connected TickTick account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Task Comments
>
> **Slug:** `TICKTICK_LIST_TASK_COMMENTS`
>
> List discussion comments attached to a task in a TickTick project.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Task whose comments to retrieve.
>
> **project\_id** `string` *required*
>
> Project containing the task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Move Tasks
>
> **Slug:** `TICKTICK_MOVE_TASKS`
>
> Move one or more existing tasks between TickTick projects.
>
> #### Input Parameters
>
> **moves** `array` *required*
>
> One or more task moves to perform in a single request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate OAuth2 Authorization URL
>
> **Slug:** `TICKTICK_OAUTH2_AUTHORIZATION_STEP1`
>
> Tool 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
>
> **scope** `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.
>
> **state** `string`
>
> An opaque value passed back to your redirect URI for CSRF protection and to maintain request state (optional).
>
> **client\_id** `string` *required*
>
> Your TickTick application's client ID obtained from the Developer Center.
>
> **redirect\_uri** `string` *required*
>
> The exact redirect URI registered with your TickTick application; the authorization code will be sent here after user approval.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Project
>
> **Slug:** `TICKTICK_UPDATE_PROJECT`
>
> Tool 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** `string ("TASK" | "NOTE")`
>
> Kind of the project, 'TASK' or 'NOTE'
>
> **name** `string`
>
> New name of the project
>
> **color** `string`
>
> Hex color code for the project, e.g. '#F18181'
>
> **viewMode** `string ("list" | "kanban" | "timeline")`
>
> View mode for the project
>
> **projectId** `string` *required*
>
> The unique project ID (24-character hex string) to update. Obtain this from TICKTICK\_GET\_USER\_PROJECT or TICKTICK\_CREATE\_PROJECT.
>
> **sortOrder** `integer`
>
> Sort order value for positioning the project in lists. Can be negative, zero, or positive. Lower values appear first.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task
>
> **Slug:** `TICKTICK_UPDATE_TASK`
>
> Updates 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
>
> **desc** `string`
>
> Extended description of the task
>
> **items** `array`
>
> Checklist (subtask) items
>
> **title** `string`
>
> New title of the task
>
> **taskId** `string` *required*
>
> Task identifier to update
>
> **content** `string`
>
> Content or notes of the task
>
> **dueDate** `string`
>
> ISO 8601 due date/time, e.g., '2023-04-24T17:00:00+0000'
>
> **isAllDay** `boolean`
>
> Set true for an all-day task
>
> **priority** `integer`
>
> Task priority (0=None, 1=Low, 3=Medium, 5=High) Only 0, 1, 3, 5 are valid; other integers are rejected.
>
> **timeZone** `string`
>
> Time zone identifier, e.g., 'America/Los\_Angeles'
>
> **projectId** `string` *required*
>
> Project identifier containing the task
>
> **reminders** `array`
>
> List of reminder triggers in RFC 5545 format, e.g., \['TRIGGER:PT10M']
>
> **sortOrder** `integer`
>
> Internal sort index for ordering tasks
>
> **startDate** `string`
>
> ISO 8601 start date/time, e.g., '2023-04-23T12:00:00+0000'
>
> **repeatFlag** `string`
>
> RRULE string for recurrence, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
