Ticktick MCP Server

MCP server for using the TickTick API

Local serverstdio

What is the Ticktick MCP Server?

MCP server for using the TickTick API

The short version

MCP Server for the TickTick API, enabling task management, project organization, habit tracking, and more.

  • ✅ Task Management: Create, read, update, and delete tasks with all available properties
  • 📊 Project Management: Create, read, update, and delete projects with customizable views
  • 📋 Subtask Support: Full support for managing subtasks within parent tasks
  • 🔄 Complete Task Control: Set priorities, due dates, reminders, and recurring rules
  • 🔐 OAuth Authentication: Full OAuth2 implementation for secure API access
  • ⚠️ Comprehensive Error Handling: Clear error messages for common issues

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Inputs:projectId (string): Project identifier
Returnsvoid
projectIdoptional string)
contentoptional string): Task content
descoptional string): Task description
isAllDayoptional boolean): Is all day subtask item
startDateoptional string): Subtask date in "yyyy-MM-dd'T'HH:mm:ssZ" format
dueDateoptional string): Task due date in "yyyy-MM-dd'T'HH:mm:ssZ" format
timeZoneoptional string): Subtask timezone
remindersoptional string[]): List of reminder triggers in iCalendar format
repeatFlagoptional string): Task repeat flag in iCalendar format
priorityoptional number): Task priority (None: 0, Low: 1, Medium: 3, High: 5)
sortOrderoptional number): Project sort order
itemsoptional array): List of subtasks with:
statusoptional number): Completion status (Normal: 0, Completed: 1)
completedTimeoptional string): Completion time in "yyyy-MM-dd'T'HH:mm:ssZ" format
idoptional string)
InputsNone
projectProject object matching TickTickProjectSchema
tasksArray of task objects matching TickTickTaskSchema
columnsOptional array of column objects with:
coloroptional string): Project color
viewModeoptional string): View mode ('list', 'kanban', 'timeline')
kindoptional string): Project kind ('TASK', 'NOTE')

How to install the Ticktick MCP Server

{
  "mcpServers": {
    "ticktick": {
      "command": "npx",
      "args": [
        "-y",
        "@alexarevalo.ai/mcp-server-ticktick"
      ],
      "env": {
        "TICKTICK_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "TICKTICK_CLIENT_SECRET": "YOUR_TICKTICK_CLIENT_SECRET",
        "TICKTICK_ACCESS_TOKEN": "YOUR_TICKTICK_ACCESS_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TICKTICK_CLIENT_IDDeclared in the maintainer’s client configuration.Check documentation
TICKTICK_CLIENT_SECRETDeclared in the maintainer’s client configuration.Check documentation
TICKTICK_ACCESS_TOKENDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Ticktick to Inputs.”
  • “Use Ticktick to Returns.”
  • “Use Ticktick to project.”

Frequently asked questions

MCP server for using the TickTick API Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.