TickTick MCP Server — AI Task Management for Claude

Stop switching apps. Just talk.

Connect Claude to your TickTick account and manage your entire task list through natural conversation — create tasks, check what's due, complete items, and stay organized without ever opening the TickTick app.

"Remind me to call the dentist on Friday" → ✅ Task created in TickTick, instantly.

What You Can Do

• Capture tasks instantly — say it out loud, Claude creates it in TickTick

• Check your day — "What's on my plate today?" gives a clean summary across all projects

• Manage priorities — Claude understands "urgent", "ASAP", "when you get a chance"

• Natural due dates — "next Monday", "end of month", "this Friday" all work

• Organize by project — add tasks to specific lists without touching the app

• Mark things done — "I finished the dentist task" → marked complete

• Full CRUD — create, read, update, complete, and delete tasks

Installation

Prerequisites

1. A TickTick account

2. Python 3.10+

3. Claude Code or Cowork

Step 1 — Clone and install dependencies

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

Step 2 — Register a TickTick app

1. Go to developer.ticktick.com

2. Click New App → fill in any name

3. Set OAuth Redirect URL to: http://localhost:8080/callback

4. Copy your Client ID and Client Secret

Step 3 — Authenticate

TICKTICK_CLIENT_ID=your_id TICKTICK_CLIENT_SECRET=your_secret .venv/bin/python3 setup_auth.py

This opens your browser to authorize the app. Click Allow — tokens are saved automatically to ~/.ticktick_mcp/tokens.json and refresh in the background.

Step 4 — Register with Claude Code

claude mcp add ticktick -- /path/to/ticktick-mcp/.venv/bin/python3 /path/to/ticktick-mcp/server.py

Replace /path/to/ticktick-mcp with the actual path (e.g. $HOME/ticktick-mcp).

Step 5 — Add the productivity skill (optional but recommended)

Copy skills/ticktick/SKILL.md into your Claude skills folder so Claude automatically recognizes task language in any conversation:

mkdir -p ~/.claude/skills/ticktick
cp skills/ticktick/SKILL.md ~/.claude/skills/ticktick/

Usage Examples

Once connected, just talk naturally:

MCP Tools Reference

Install as a Cowork Plugin

This repo is structured as a Claude plugin. Add it in Cowork:

1. Open Manage Plugins → Marketplaces tab

2. Paste: https://github.com/Salen-Project/ticktick-mcp

3. Click Add

Or via Claude Code CLI:

claude plugins add Salen-Project/ticktick-mcp

The plugin includes the TickTick skill, which teaches Claude to automatically recognize task-related language in any conversation — no need to say "use TickTick" every time.

Why This Over Other TickTick Integrations?

• ✅ Official API — uses TickTick's open OAuth 2.0 API, not unofficial endpoints

• ✅ Automated OAuth — one-command setup, tokens refresh automatically in the background

• ✅ Cowork skill included — Claude proactively recognizes task language without explicit prompting

• ✅ Privacy-first — runs 100% locally, your data never passes through a third-party server

• ✅ Full CRUD — not read-only; create, update, complete, and delete tasks

Troubleshooting

"Given client ID does not match" — Double-check your Client ID on developer.ticktick.com. It's case-sensitive.

Port 8080 already in use — Run lsof -ti:8080 | xargs kill -9 then retry setup_auth.py.

Tokens expired — Re-run setup_auth.py to get fresh tokens.

Claude doesn't recognize TickTick commands — Make sure the MCP is registered (claude mcp list) and the skill is installed.

Links

• 🌐 Glama listing

• 📦 GitHub Releases

• 🐞 Report an issue

• 🔑 TickTick Developer Portal

License

MIT © Salen-Project