# 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](https://toolhouse.app/auth-connections?authkit_slugs=ticktick). ## Tools (14) ### `Ticktick Complete Task` Integration 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. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ---------------------------- | --------------------------------------------------- | | `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` Integration 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. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `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` Integration 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. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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` Integration 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. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | `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` Integration 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. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `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` Integration 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. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ---------------------------- | ------------------------------------------------- | | `task_id` | string | ✅ | `"63b7bebb91c0a5474805fcd4"` | Task identifier to delete. | | `project_id` | string | ✅ | `"6226ff9877acee87727f6bca"` | Project identifier containing the task to delete. | *** ### `Ticktick Get Project By Id` Integration 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. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ---------------------------- | ---------------------------------------- | | `projectId` | string | ✅ | `"693959ae8f08df3f780806ab"` | The unique ID of the project to retrieve | *** ### `Ticktick Get Project With Data` Integration 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. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ---------------------------- | --------------------------------------- | | `projectId` | string | ✅ | `"6226ff9877acee87727f6bca"` | Project identifier to retrieve data for | *** ### `Ticktick Get Task By Project And Id` Integration 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. | Parameter | Type | Required | Example | Description | | ------------ | ------ | :------: | ---------------------------- | ------------------------------------------------ | | `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` Integration 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` Integration 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. | Parameter | Type | Required | Example | Description | | ----------------------- | ------- | :------: | --------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | `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` Integration 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. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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` Integration 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. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `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` Integration 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. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------------------------------------ | ------------------------------------------------------------------------------------------------------- | | `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' | *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/ticktick.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.