Install TickTick MCP

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.

Prepare the server locally

Run this once before adding it to Claude Code.

git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Register it in Claude Code

claude mcp add -e "TICKTICK_CLIENT_ID=${TICKTICK_CLIENT_ID}" -e "TICKTICK_CLIENT_SECRET=${TICKTICK_CLIENT_SECRET}" ticktick-mcp -- /path/to/ticktick-mcp/.venv/bin/python3 /path/to/ticktick-mcp/server.py

Replace any placeholder paths in the command with the real path on your machine.

Required:TICKTICK_CLIENT_IDTICKTICK_CLIENT_SECRET

Environment Variables

Set these before running TickTick MCP.

VariableDescriptionRequired

TICKTICK_CLIENT_IDClient ID from developer.ticktick.comYes

TICKTICK_CLIENT_SECRETClient Secret from developer.ticktick.comYes

Available Tools (7)

Once configured, TickTick MCP gives your AI agent access to:

ticktick_list_projectsList all your TickTick projects/lists

ticktick_list_tasksList tasks in a specific project

project_id

ticktick_create_taskCreate a task with title, due date, priority, project

titledue_datepriorityproject_id

ticktick_get_taskGet full details of a specific task

task_id

ticktick_update_taskUpdate a task's title, due date, or priority

task_idtitledue_datepriority

ticktick_complete_taskMark a task as completed

task_id

ticktick_delete_taskPermanently delete a task

task_id

Try It Out

After setup, try these prompts with your AI agent:

→Remind me to call the dentist on Friday

→Add 'review Q1 report' to my Work project, high priority

→What's on my to-do list today?

→I finished the dentist task

→What did I add this week?

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Python 3.8+ with pip installed
TICKTICK_CLIENT_ID — Client ID from developer.ticktick.com
TICKTICK_CLIENT_SECRET — Client Secret from developer.ticktick.com

Alternative installation methods

Claude Code CLI

claude plugins add Salen-Project/ticktick-mcp

Keep this setup from going cold

Save the docs, env vars, and workflow around TickTick MCP in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup

← TickTick MCP overview Browse ai-tools servers →