Ticktick

14 tools available

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

productivity task management

Connect Ticktick Visit Ticktick ↗

Connect Ticktick to Definable to capture notes by voice or chat, roll up daily activity, retrieve anything by description. Personas call Ticktick's 14 tools directly from chat or scheduled flows. Wire it to your assistant — capture, organise, and recall through one conversation.

Common workflows with Ticktick

Capture from chat

Tell the persona to remember something
Agent writes it to this tool
Returns a link for confirmation

Daily roll-up

Pull yesterday's activity
Summarise as a digest
Save it back into this tool

Smart retrieval

Ask "where did I write about X?"
Agent searches
Returns the page with context

Ticktick actions 14

Every Ticktick action below is a callable tool any Definable persona can invoke.

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.

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.

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.

Create Task (Deprecated)

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.

Delete TickTick 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.

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.

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.

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.

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.

Get User Projects

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.

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.

Generate OAuth2 Authorization URL

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.

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.

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.

Frequently asked questions

What can I automate with Ticktick on Definable?

Anything Ticktick exposes through its API. Common productivity workflows on Definable include capture notes by voice or chat, roll up daily activity, retrieve anything by description. Personas can call any of the 14 Ticktick tools directly, then chain the result into another integration without you writing code.

How does Ticktick authentication work?

Ticktick uses OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Ticktick integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 14 Ticktick tools. You only need a separate Ticktick subscription if Ticktick itself charges per seat or per API call.

Is using Ticktick through Definable secure?

Every call from a persona to Ticktick is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Ticktick on Definable?

Sign up for Definable, open the integrations page, find Ticktick, and connect via OAuth or API key. You can immediately attach Ticktick to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Ticktick actions does Definable expose?

Definable exposes all 14 Ticktick actions as callable tools — including `Complete Task`, `Create Project`, `Create Task`, plus 11 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Ticktick?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations