Can I use TickTick as a CLI?

Yes. KosmoKrator exposes a TickTick CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose TickTick through MCP?

Yes. The KosmoKrator MCP gateway can expose selected TickTick tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are TickTick credentials stored?

TickTick credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for TickTick MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

TickTick CLI for AI Agents

Use the TickTick CLI from KosmoKrator to call TickTick tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

9 functions 3 read 6 write OAuth browser flow auth

Submit TickTick feedback View package source

TickTick CLI Setup

TickTick is discoverable, but headless credential setup is not fully supported yet.

Headless setup is limited for this integration. It remains documented because stored credentials or future proxy-backed execution can still make the runtime useful.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure ticktick --set access_token="$TICKTICK_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor ticktick --json
kosmokrator integrations:status --json

Credentials

Authentication type: OAuth browser flow oauth2_authorization_code. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`TICKTICK_ACCESS_TOKEN`	OAuth token `oauth`	yes	Access Token

Call TickTick Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call ticktick.ticktick_list_projects '{}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:ticktick ticktick_list_projects '{}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs ticktick --json
kosmo integrations:docs ticktick.ticktick_list_projects --json
kosmo integrations:schema ticktick.ticktick_list_projects --json
kosmo integrations:search "TickTick" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to TickTick.

`ticktick.ticktick_list_projects`

Read read

List all TickTick projects (task lists). Returns project names, IDs, and metadata. Use this first to discover available projects before working with tasks.

Parameters: none

Generic CLI call

kosmo integrations:call ticktick.ticktick_list_projects '{}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_list_projects '{}' --json

`ticktick.ticktick_get_project`

Read read

Get a TickTick project with all its tasks, sections, and columns. Use this to see everything in a project at once.

Parameters: project_id

Generic CLI call

kosmo integrations:call ticktick.ticktick_get_project '{"project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_get_project '{"project_id":"example_project_id"}' --json

`ticktick.ticktick_create_project`

Write write

Create a new TickTick project (task list).

Parameters: name, color, view_mode

Generic CLI call

kosmo integrations:call ticktick.ticktick_create_project '{"name":"example_name","color":"example_color","view_mode":"example_view_mode"}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_create_project '{"name":"example_name","color":"example_color","view_mode":"example_view_mode"}' --json

`ticktick.ticktick_delete_project`

Write write

Delete a TickTick project and all its tasks. This action cannot be undone.

Parameters: project_id

Generic CLI call

kosmo integrations:call ticktick.ticktick_delete_project '{"project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_delete_project '{"project_id":"example_project_id"}' --json

`ticktick.ticktick_get_tasks`

Read read

Get all tasks in a TickTick project. Returns task titles, IDs, priorities, due dates, and subtasks.

Parameters: project_id

Generic CLI call

kosmo integrations:call ticktick.ticktick_get_tasks '{"project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_get_tasks '{"project_id":"example_project_id"}' --json

`ticktick.ticktick_create_task`

Write write

Create a new task in TickTick. If no project_id is given, the task goes to the Inbox. Supports subtasks via the items array.

Parameters: title, project_id, content, start_date, due_date, priority, is_all_day, items

Generic CLI call

kosmo integrations:call ticktick.ticktick_create_task '{"title":"example_title","project_id":"example_project_id","content":"example_content","start_date":"example_start_date","due_date":"example_due_date","priority":1,"is_all_day":true,"items":"example_items"}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_create_task '{"title":"example_title","project_id":"example_project_id","content":"example_content","start_date":"example_start_date","due_date":"example_due_date","priority":1,"is_all_day":true,"items":"example_items"}' --json

`ticktick.ticktick_update_task`

Write write

Update an existing TickTick task. Requires both the task ID and its project ID. Only provided fields will be changed.

Parameters: task_id, project_id, title, content, start_date, due_date, priority

Generic CLI call

kosmo integrations:call ticktick.ticktick_update_task '{"task_id":"example_task_id","project_id":"example_project_id","title":"example_title","content":"example_content","start_date":"example_start_date","due_date":"example_due_date","priority":1}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_update_task '{"task_id":"example_task_id","project_id":"example_project_id","title":"example_title","content":"example_content","start_date":"example_start_date","due_date":"example_due_date","priority":1}' --json

`ticktick.ticktick_complete_task`

Write write

Mark a TickTick task as complete.

Parameters: project_id, task_id

Generic CLI call

kosmo integrations:call ticktick.ticktick_complete_task '{"project_id":"example_project_id","task_id":"example_task_id"}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_complete_task '{"project_id":"example_project_id","task_id":"example_task_id"}' --json

`ticktick.ticktick_delete_task`

Write write

Delete a TickTick task. This action cannot be undone.

Parameters: project_id, task_id

Generic CLI call

kosmo integrations:call ticktick.ticktick_delete_task '{"project_id":"example_project_id","task_id":"example_task_id"}' --json

Provider shortcut

kosmo integrations:ticktick ticktick_delete_task '{"project_id":"example_project_id","task_id":"example_task_id"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`ticktick.ticktick_list_projects`

List all TickTick projects (task lists). Returns project names, IDs, and metadata. Use this first to discover available projects before working with tasks.

Operation: Read read
Schema command: kosmo integrations:schema ticktick.ticktick_list_projects --json

Parameter	Type	Required	Description
No parameters.

`ticktick.ticktick_get_project`

Get a TickTick project with all its tasks, sections, and columns. Use this to see everything in a project at once.

Operation: Read read
Schema command: kosmo integrations:schema ticktick.ticktick_get_project --json

Parameter	Type	Required	Description
`project_id`	string	yes	The project ID. Use ticktick_list_projects to find project IDs.

`ticktick.ticktick_create_project`

Create a new TickTick project (task list).

Operation: Write write
Schema command: kosmo integrations:schema ticktick.ticktick_create_project --json

Parameter	Type	Required	Description
`name`	string	yes	Name of the project.
`color`	string	no	Color of the project (e.g., "#ff8c00").
`view_mode`	string	no	View mode: "list", "kanban", or "timeline".

`ticktick.ticktick_delete_project`

Delete a TickTick project and all its tasks. This action cannot be undone.

Operation: Write write
Schema command: kosmo integrations:schema ticktick.ticktick_delete_project --json

Parameter	Type	Required	Description
`project_id`	string	yes	The project ID to delete. Use ticktick_list_projects to find project IDs.

`ticktick.ticktick_get_tasks`

Get all tasks in a TickTick project. Returns task titles, IDs, priorities, due dates, and subtasks.

Operation: Read read
Schema command: kosmo integrations:schema ticktick.ticktick_get_tasks --json

Parameter	Type	Required	Description
`project_id`	string	yes	The project ID to get tasks from. Use ticktick_list_projects to find project IDs.

`ticktick.ticktick_create_task`

Create a new task in TickTick. If no project_id is given, the task goes to the Inbox. Supports subtasks via the items array.

Operation: Write write
Schema command: kosmo integrations:schema ticktick.ticktick_create_task --json

Parameter	Type	Required	Description
`title`	string	yes	Task title.
`project_id`	string	no	Project ID to create the task in. Omit to add to Inbox.
`content`	string	no	Task description/notes.
`start_date`	string	no	Start date in ISO 8601 format (e.g., "2026-02-15T09:00:00+0000").
`due_date`	string	no	Due date in ISO 8601 format (e.g., "2026-02-15T17:00:00+0000").
`priority`	integer	no	Priority: 0 = none, 1 = low, 3 = medium, 5 = high.
`is_all_day`	boolean	no	Whether this is an all-day task (true) or has specific times (false).
`items`	string	no	JSON array of subtasks, e.g., [{"title": "Subtask 1", "status": 0}]. Status: 0 = unchecked, 2 = checked.

`ticktick.ticktick_update_task`

Update an existing TickTick task. Requires both the task ID and its project ID. Only provided fields will be changed.

Operation: Write write
Schema command: kosmo integrations:schema ticktick.ticktick_update_task --json

Parameter	Type	Required	Description
`task_id`	string	yes	The task ID to update.
`project_id`	string	yes	The project ID the task belongs to.
`title`	string	no	New title for the task.
`content`	string	no	New description/notes for the task.
`start_date`	string	no	New start date in ISO 8601 format.
`due_date`	string	no	New due date in ISO 8601 format.
`priority`	integer	no	New priority: 0 = none, 1 = low, 3 = medium, 5 = high.

`ticktick.ticktick_complete_task`

Mark a TickTick task as complete.

Operation: Write write
Schema command: kosmo integrations:schema ticktick.ticktick_complete_task --json

Parameter	Type	Required	Description
`project_id`	string	yes	The project ID the task belongs to.
`task_id`	string	yes	The task ID to complete.

`ticktick.ticktick_delete_task`

Delete a TickTick task. This action cannot be undone.

Operation: Write write
Schema command: kosmo integrations:schema ticktick.ticktick_delete_task --json

Parameter	Type	Required	Description
`project_id`	string	yes	The project ID the task belongs to.
`task_id`	string	yes	The task ID to delete.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.