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 Headless Automation

Use the TickTick CLI for headless automation 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 Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. 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 Headless Automation
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. Coding Agents TickTick CLI for coding agents.