Ticktick
Your Toolhouse AI Worker can connect to Ticktick using 14 specialized tools.
Auth Connection
This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.
Tools (14)
Ticktick Complete Task
Ticktick Complete TaskIntegration name: TICKTICK_COMPLETE_TASK
Marks 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
task_id
string
✅
"63b7bebb91c0a5474805fcd4"
Identifier of the task to mark as complete.
project_id
string
✅
"6226ff9877acee87727f6bca"
Project identifier containing the task to complete.
Ticktick Create Project
Ticktick Create ProjectIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
kind
string
"TASK"
Type of project: 'TASK' for task management or 'NOTE' for note-taking. Defaults to 'TASK' if not specified.
name
string
✅
"My Project"
Name of the new project. This will be displayed in the TickTick interface.
color
string
"#F18181"
Hex color code for the project appearance (e.g., '#F18181'). Must include the '#' prefix.
viewMode
string
"list"
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
0
Sort order value for positioning the project in lists. Can be negative, zero, or positive. Lower values appear first.
Ticktick Create Task
Ticktick Create TaskIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
desc
string
"Grocery shopping for the weekend"
Extended description of the task
items
array
—
Checklist (subtask) items
title
string
✅
"Buy groceries"
Title of the task
content
string
"Remember to pick up eggs and bread"
Main content or notes of the task
dueDate
string
"2023-04-24T17:00:00+0000"
ISO 8601 due date/time, e.g., '2023-04-24T17:00:00+0000'
isAllDay
boolean
false
Set true for an all-day task
priority
integer
3
Task priority (0=None, 1=Low, 3=Medium, 5=High)
timeZone
string
—
Time zone identifier, e.g., 'America/Los_Angeles'
projectId
string
"5e8f7a2b3b2f4c1a2d3e4f5g"
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
["TRIGGER:PT10M"]
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
12345
Internal sort index
startDate
string
—
ISO 8601 start date/time, e.g., '2023-04-23T12:00:00+0000'
repeatFlag
string
"RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR"
RRULE string for recurrence, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'
Ticktick Create Task2
Ticktick Create Task2Integration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
desc
string
"Additional task details"
Description of the task or checklist
items
array
—
The list of subtasks (checklist items) for this task
title
string
✅
"Buy groceries"
Title of the task
content
string
"This is a test task created by the curl tester agent"
Task content or notes
dueDate
string
"2023-04-24T17:00:00+0000"
Due date and time in yyyy-MM-ddTHH:mm:ssZ format
isAllDay
boolean
false
Set true for an all-day task
priority
integer
3
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
✅
"686b71211f7eb96a6a5040f6"
ID of the project (list) to add the task to. Use TICKTICK_GET_USER_PROJECT to get available project IDs.
reminders
array
["TRIGGER:PT10M"]
Lists of reminders specific to the task in RFC 5545 format, e.g., ['TRIGGER:PT10M']
sortOrder
integer
12345
The order of task for sorting purposes
startDate
string
"2023-04-23T12:00:00+0000"
Start date and time in yyyy-MM-ddTHH:mm:ssZ format
repeatFlag
string
"RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR"
Recurring rules of task in RRULE format, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'
Ticktick Delete Project
Ticktick Delete ProjectIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
project_id
string
✅
"6226ff9877acee87727f6bca"
The unique identifier of the TickTick project to delete. Obtain this from TICKTICK_GET_USER_PROJECT or TICKTICK_CREATE_PROJECT actions.
Ticktick Delete Task
Ticktick Delete TaskIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
task_id
string
✅
"63b7bebb91c0a5474805fcd4"
Task identifier to delete.
project_id
string
✅
"6226ff9877acee87727f6bca"
Project identifier containing the task to delete.
Ticktick Get Project By Id
Ticktick Get Project By IdIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
projectId
string
✅
"693959ae8f08df3f780806ab"
The unique ID of the project to retrieve
Ticktick Get Project With Data
Ticktick Get Project With DataIntegration name: TICKTICK_GET_PROJECT_WITH_DATA
Retrieve 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
projectId
string
✅
"6226ff9877acee87727f6bca"
Project identifier to retrieve data for
Ticktick Get Task By Project And Id
Ticktick Get Task By Project And IdIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
task_id
string
✅
"693959d98f08df3f78080de3"
The unique ID of the specific task to retrieve
project_id
string
✅
"inbox128986323"
The unique ID of the project containing the task
Ticktick Get User Project
Ticktick Get User ProjectIntegration name: TICKTICK_GET_USER_PROJECT
Retrieves 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. No parameters required.
Ticktick List All Tasks
Ticktick List All TasksIntegration name: TICKTICK_LIST_ALL_TASKS
Tool 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
limit
integer
50
Optional maximum number of tasks to return. Applied after aggregating all tasks.
projectIds
array
["6226ff9877acee87727f6bca","6336ff9877acee87727f6bcd"]
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.
Ticktick Oauth2 Authorization Step1
Ticktick Oauth2 Authorization Step1Integration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
scope
string
✅
"tasks:read tasks:write"
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
"secure_random_state_1234"
An opaque value passed back to your redirect URI for CSRF protection and to maintain request state (optional).
client_id
string
✅
"your_client_id_here"
Your TickTick application's client ID obtained from the Developer Center.
redirect_uri
string
✅
"https://yourapp.com/oauth/callback"
The exact redirect URI registered with your TickTick application; the authorization code will be sent here after user approval.
Ticktick Update Project
Ticktick Update ProjectIntegration name: 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
kind
string
"TASK"
Kind of the project, 'TASK' or 'NOTE'
name
string
"New Project Name"
New name of the project
color
string
"#F18181"
Hex color code for the project, e.g. '#F18181'
viewMode
string
"list"
View mode for the project
projectId
string
✅
"6226ff9877acee87727f6bca"
The unique project ID (24-character hex string) to update. Obtain this from TICKTICK_GET_USER_PROJECT or TICKTICK_CREATE_PROJECT.
sortOrder
integer
0
Sort order value for positioning the project in lists. Can be negative, zero, or positive. Lower values appear first.
Ticktick Update Task
Ticktick Update TaskIntegration name: TICKTICK_UPDATE_TASK
Tool 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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
desc
string
"Weekend shopping list"
Extended description of the task
items
array
—
Checklist (subtask) items
title
string
"Buy groceries"
New title of the task
taskId
string
✅
"5e8f7a2b3b2f4c1a2d3e4f5g"
Task identifier to update
content
string
"Remember to pick up eggs"
Content or notes of the task
dueDate
string
"2023-04-24T17:00:00+0000"
ISO 8601 due date/time, e.g., '2023-04-24T17:00:00+0000'
isAllDay
boolean
false
Set true for an all-day task
priority
integer
3
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
✅
"6226ff9877acee87727f6bca"
Project identifier containing the task
reminders
array
["TRIGGER:PT10M"]
List of reminder triggers in RFC 5545 format, e.g., ['TRIGGER:PT10M']
sortOrder
integer
12345
Internal sort index for ordering tasks
startDate
string
—
ISO 8601 start date/time, e.g., '2023-04-23T12:00:00+0000'
repeatFlag
string
"RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR"
RRULE string for recurrence, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'