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 Coding Agents

Use the TickTick CLI for coding agents with headless JSON commands, schema discovery, credentials, and permission controls.

9 functions 3 read 6 write OAuth browser flow auth

Submit TickTick feedback View package source

TickTick CLI for Coding Agents

Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

Use this pattern when another coding agent needs exact commands and schema discovery. The TickTick CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# TickTick CLI for Coding Agents
kosmokrator integrations:configure ticktick --set access_token="$TICKTICK_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call ticktick.ticktick_list_projects '{}' --json

Discovery Before Execution

Agents and scripts can inspect TickTick docs and schemas 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

Useful TickTick CLI Functions

Function	Type	Parameters	Description
`ticktick.ticktick_list_projects`	Read	none	List all TickTick projects (task lists). Returns project names, IDs, and metadata. Use this first to discover available projects before working with tasks.
`ticktick.ticktick_get_project`	Read	project_id	Get a TickTick project with all its tasks, sections, and columns. Use this to see everything in a project at once.
`ticktick.ticktick_create_project`	Write	name, color, view_mode	Create a new TickTick project (task list).
`ticktick.ticktick_delete_project`	Write	project_id	Delete a TickTick project and all its tasks. This action cannot be undone.
`ticktick.ticktick_get_tasks`	Read	project_id	Get all tasks in a TickTick project. Returns task titles, IDs, priorities, due dates, and subtasks.
`ticktick.ticktick_create_task`	Write	title, project_id, content, start_date, due_date, priority, is_all_day, items	Create a new task in TickTick. If no project_id is given, the task goes to the Inbox. Supports subtasks via the items array.
`ticktick.ticktick_update_task`	Write	task_id, project_id, title, content, start_date, due_date, priority	Update an existing TickTick task. Requires both the task ID and its project ID. Only provided fields will be changed.
`ticktick.ticktick_complete_task`	Write	project_id, task_id	Mark a TickTick task as complete.
`ticktick.ticktick_delete_task`	Write	project_id, task_id	Delete a TickTick task. This action cannot be undone.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related TickTick CLI Pages

CI TickTick CLI for CI. Cron Jobs TickTick CLI for cron jobs. Shell Scripts TickTick CLI for shell scripts. Headless Automation TickTick CLI for headless automation.