KosmoKrator

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.

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.

Agent Surfaces

TickTick CLIHeadless setup, JSON output, direct function calls. TickTick MCPExpose selected tools to local MCP clients. TickTick LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug
ticktick
route_slug
ticktick
package
ticktick
auth_strategy
oauth2_authorization_code
cli_setup_supported
false
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true

Function Catalog

FunctionTypeParametersDescription
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.