> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxd.sh/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 is a cross-platform task management and to-do list application designed to help users organize their tasks and schedules efficiently.

`ticktick` · **14 tools** · no triggers

## Connect it

```bash theme={"theme":"github-dark"}
run auth ticktick
run auth ticktick --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run ticktick          # common commands
run ticktick --all    # every command
```

```ts theme={"theme":"github-dark"}
import { ticktick } from "@boxd/run";
```

## Common tools

| Tool                         | What it does                                                                                                                                                            |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create-task2`               | DEPRECATED: Use TICKTICK\_CREATE\_TASK instead. Tool to create a new task in a specified project.                                                                       |
| `get-project-by-id`          | Tool to retrieve a specific TickTick project by its unique ID.                                                                                                          |
| `get-task-by-project-and-id` | Tool to retrieve a specific TickTick task by project ID and task ID.                                                                                                    |
| `list-all-tasks`             | Tool to list all open/undone tasks across all user projects in one call.                                                                                                |
| `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. |

<Accordion title="All 14 tools" icon="list">
  | Tool                         | What it does                                                                                                                                                            |
  | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `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. |
  | `create-project`             | Create a new project (list) in TickTick. Projects organize tasks and notes.                                                                                             |
  | `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-task2`               | DEPRECATED: Use TICKTICK\_CREATE\_TASK instead. Tool to create a new task in a specified project.                                                                       |
  | `delete-project`             | Permanently deletes a TickTick project by its ID. All tasks within the project will also be deleted.                                                                    |
  | `delete-task`                | Tool to permanently delete a specific task - irreversible, no recovery.                                                                                                 |
  | `get-project-by-id`          | Tool to retrieve a specific TickTick project by its unique ID.                                                                                                          |
  | `get-project-with-data`      | Retrieve a project's associated data (incomplete tasks, columns).                                                                                                       |
  | `get-task-by-project-and-id` | Tool to retrieve a specific TickTick task by project ID and task ID.                                                                                                    |
  | `get-user-project`           | Retrieves all projects accessible to the authenticated user, including personal and shared projects.                                                                    |
  | `list-all-tasks`             | Tool to list all open/undone tasks across all user projects in one call.                                                                                                |
  | `oauth2-authorization-step1` | Tool to generate the TickTick OAuth2 authorization URL. Use to redirect the user to obtain the authorization code (step 1).                                             |
  | `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.                                                                                         |
</Accordion>

[Open TickTick in the console →](https://app.boxd.sh/integrations/detail/ticktick)