TickTick MCP Server
Provides tools for managing TickTick projects and tasks, including CRUD operations, search/filter by priority and date, GTD support (engaged/next tasks), batch creation, and subtask management.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TickTick MCP Servershow my tasks due today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TickTick MCP Server
A remote Model Context Protocol (MCP) server for TickTick task management, hosted on Cloudflare Workers.
Provides 22 MCP tools for managing TickTick projects and tasks via any MCP client (Claude Desktop, etc.).
Features
Project Management: Create, read, delete projects
Task CRUD: Create, read, update, complete, delete tasks
Search & Filter: Search tasks, filter by priority, date ranges
GTD Support: Engaged tasks, next tasks, batch creation, subtasks
Authentication: GitHub OAuth for MCP clients, TickTick API token for backend
Setup
1. Prerequisites
2. Clone and Install
git clone https://github.com/k-wakamatsu-tms/ticktick-mcp-server.git
cd ticktick-mcp-server
npm install3. Configure Secrets
wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET
wrangler secret put GITHUB_ALLOWED_LOGINS
wrangler secret put COOKIE_ENCRYPTION_KEY
wrangler secret put TICKTICK_ACCESS_TOKEN
wrangler secret put TICKTICK_CLIENT_ID
wrangler secret put TICKTICK_CLIENT_SECRETFor local development, copy .dev.vars.example to .dev.vars and fill in the values.
4. Create KV Namespace
wrangler kv namespace create OAUTH_KVUpdate the id in wrangler.jsonc with the returned namespace ID.
5. Deploy
npm run deploy6. Connect from Claude Desktop
Add to your Claude Desktop MCP config:
{
"mcpServers": {
"ticktick": {
"command": "npx",
"args": [
"mcp-remote",
"https://ticktick-mcp-server.<your-subdomain>.workers.dev/mcp"
]
}
}
}Local Development
cp .dev.vars.example .dev.vars
# Edit .dev.vars with your credentials
npm run devAvailable Tools (22)
Projects (4)
Tool | Description |
| Get all projects |
| Get a specific project |
| Create a new project |
| Delete a project |
Task CRUD (6)
Tool | Description |
| Get all tasks in a project |
| Get a specific task |
| Create a new task |
| Update an existing task |
| Mark a task as complete |
| Delete a task |
Search & Filter (8)
Tool | Description |
| Get all tasks from all projects |
| Search tasks by keyword |
| Filter by priority level |
| Tasks due today |
| Tasks due tomorrow |
| Tasks due in N days |
| Tasks due this week |
| Overdue tasks |
GTD & Batch (4)
Tool | Description |
| High priority / due today / overdue |
| Medium priority / due tomorrow |
| Create multiple tasks at once |
| Create a subtask under a parent |
Environment Variables
Variable | Purpose |
| GitHub OAuth App client ID |
| GitHub OAuth App client secret |
| Comma-separated allowed GitHub usernames (unset denies all access) |
| Random key for cookie signing |
| TickTick API access token |
| TickTick app client ID (for future refresh) |
| TickTick app client secret (for future refresh) |
License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/k-wakamatsu-tms/ticktick-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server