TickTick MCP Server

MCP server for TickTick integration

Local serverstdioTypeScript

What is the TickTick MCP Server?

MCP server for TickTick integration

What it actually does

A Model Context Protocol (MCP) server that provides integration with TickTick task management service.

  • List tasks and projects with enhanced display (human-readable priorities)
  • Create, update, and delete tasks
  • Mark tasks as completed
  • Get specific task details
  • Timezone handling with manual D+1 adjustment for accurate due date calculations
  • Get overdue tasks with configurable timezone offset

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
get_tasksGet all tasks or tasks from a specific project (with enhanced display)
get_overdue_tasksGet overdue tasks with timezone compensation (configurable offset, defaults to UTC+8 - adjust for your timezone)
get_todays_tasksGet tasks due today with D+1 timezone adjustment
get_projectsGet all projects from TickTick
create_taskCreate a new task with priority, tags, due dates
update_taskUpdate an existing task
delete_taskDelete a task
complete_taskMark a task as completed
get_taskGet a specific task by ID

How to install the TickTick MCP Server

{
  "mcpServers": {
    "ticktick": {
      "command": "node",
      "args": ["/path/to/ticktick-mcp-server/dist/index.js"],
      "env": {
        "TICKTICK_ACCESS_TOKEN": "your_oauth_token",
        "TICKTICK_REFRESH_TOKEN": "your_refresh_token",
        "TICKTICK_CLIENT_ID": "your_client_id",
        "TICKTICK_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
TICKTICK_ACCESS_TOKENCredential the server authenticates with.Yes
TICKTICK_REFRESH_TOKENCredential the server authenticates with.Yes
TICKTICK_CLIENT_IDConfiguration value read at startup.Optional
TICKTICK_CLIENT_SECRETCredential the server authenticates with.Yes
TICKTICK_USERNAMEConfiguration value read at startup.Optional
TICKTICK_PASSWORDConfiguration value read at startup.Optional

Example prompts to try

  • “Use TickTick to get tasks.”
  • “Use TickTick to get overdue tasks.”
  • “Use TickTick to get todays tasks.”

Frequently asked questions

It supports OAuth (recommended) via access/refresh tokens plus client credentials, and username/password authentication.