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 MCP, CLI, and Lua Integration for AI Agents

TickTick integration docs for AI agents: MCP gateway setup, TickTick CLI commands, Lua API reference, credentials, and function schemas.

9 functions 3 read 6 write OAuth browser flow auth

Submit TickTick feedback View package source

TickTick for agents

OAuth setup requires a web browser redirect, but CLI runtime works after credentials are stored.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: ticktick
route_slug: ticktick
package: ticktick
auth_strategy: oauth2_authorization_code OAuth browser flow
cli_setup_supported: false
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. TickTick CLIHeadless setup and direct function calls. TickTick MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

TickTick MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for TickTick.

TickTick CLI Matrix

Use these pages for direct TickTick CLI workflows in scripts, CI, cron, and agent wrappers.

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. Coding Agents TickTick CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`ticktick.ticktick_list_projects`	Read `read`	0	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 `read`	1	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 `write`	3	Create a new TickTick project (task list).
`ticktick.ticktick_delete_project`	Write `write`	1	Delete a TickTick project and all its tasks. This action cannot be undone.
`ticktick.ticktick_get_tasks`	Read `read`	1	Get all tasks in a TickTick project. Returns task titles, IDs, priorities, due dates, and subtasks.
`ticktick.ticktick_create_task`	Write `write`	8	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 `write`	7	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 `write`	2	Mark a TickTick task as complete.
`ticktick.ticktick_delete_task`	Write `write`	2	Delete a TickTick task. This action cannot be undone.