TickTick MCP Server
Manages tasks, projects, and GTD workflows in TickTick, including creating, updating, completing, deleting tasks, listing projects, searching tasks, and filtering by due dates (today, tomorrow, this week, overdue). Supports both TickTick and Dida365 (China version).
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
TickTick MCP Server
A security-hardened Model Context Protocol (MCP) server for TickTick that enables managing your tasks directly through any MCP-compatible client.
Works With Any MCP Client
This server works with any MCP-compatible client:
Claude Desktop
Cursor
Cline
Continue
Any MCP-compatible IDE or tool
Related MCP server: ticktick-mcp-server
Quick Start
1. Get TickTick API Credentials
Create a new app with redirect URI:
http://localhost:8080/callbackCopy your Client ID and Client Secret
2. Authenticate (One-Time Setup)
Run this command and enter your credentials when prompted:
uvx ticktick-mcp-server authThis opens your browser to authorize with TickTick. Your tokens are securely saved to ~/.config/ticktick-mcp/credentials.json.
3. Configure Your MCP Client
Add to your MCP client config:
{
"mcpServers": {
"ticktick": {
"command": "uvx",
"args": ["ticktick-mcp-server", "run"],
"env": {
"TICKTICK_CLIENT_ID": "your-client-id-here",
"TICKTICK_CLIENT_SECRET": "your-client-secret-here"
}
}
}
}Client | macOS | Windows |
Claude Desktop |
|
|
Cursor |
|
|
4. Restart Your Client
That's it! Now you can:
"Show me all my TickTick projects"
"What tasks are due today?"
"Create a task to buy groceries in my Shopping list"
Alternative Installation
Using pip
pip install ticktick-mcp-server
ticktick-mcp-server authDida365 (滴答清单) Support
For the China version of TickTick, add these environment variables to your MCP config:
{
"mcpServers": {
"ticktick": {
"command": "uvx",
"args": ["ticktick-mcp-server", "run"],
"env": {
"TICKTICK_CLIENT_ID": "your-client-id",
"TICKTICK_CLIENT_SECRET": "your-client-secret",
"TICKTICK_BASE_URL": "https://api.dida365.com/open/v1",
"TICKTICK_AUTH_URL": "https://dida365.com/oauth/authorize",
"TICKTICK_TOKEN_URL": "https://dida365.com/oauth/token"
}
}
}
}Register your app at Dida365 Developer Center.
Available Tools
Projects
Tool | Description |
| List all projects |
| Get project details |
| Create a new project |
| Delete a project |
Tasks
Tool | Description |
| Get task details |
| Create a new task |
| Update a task |
| Mark task complete |
| Delete a task |
| Get all tasks |
| Search tasks |
Date Filters
Tool | Description |
| Tasks due today |
| Tasks due tomorrow |
| Tasks due this week |
| Overdue tasks |
GTD Workflow
Tool | Description |
| High priority + overdue |
| Medium priority + due tomorrow |
| Create multiple tasks |
Example Prompts
"Show me all my TickTick projects"
"What tasks do I have due today?"
"Create a high priority task 'Finish report' in my Work project"
"Mark 'Buy groceries' as complete"
"Show me everything that's overdue"
"Break down 'Plan vacation' into 5 subtasks"Credential Storage
Tokens are stored securely in:
macOS/Linux:
~/.config/ticktick-mcp/credentials.jsonWindows:
%APPDATA%/ticktick-mcp/credentials.json
To re-authenticate, run uvx ticktick-mcp-server auth again.
Why This Fork?
This is a security-hardened fork of jacepark12/ticktick-mcp with 9 vulnerabilities fixed:
Severity | Issue | Status |
Critical | CSRF in OAuth callback | Fixed |
High | Insecure credential file permissions | Fixed |
High | OAuth server binds to all interfaces | Fixed |
High | No explicit TLS verification | Fixed |
Medium | Sensitive data in error messages | Fixed |
Medium | No rate limiting on OAuth | Fixed |
Medium | Bare except catches signals | Fixed |
Medium | Path traversal in IDs | Fixed |
Medium | Race conditions in state | Fixed |
License
MIT License - see LICENSE file for details.
Credits
Fork of jacepark12/ticktick-mcp.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA MCP server for TickTick that enables interacting with your TickTick task management system directly through Claude and other MCP clients.297-
- AlicenseNot gradedqualityCmaintenanceMCP server for TickTick API enabling task management, project organization, habit tracking, and more.37 npm73MIT
- AlicenseNot gradedqualityFmaintenanceA remote multi-user MCP server that enables task management with TickTick through tools like listing projects, creating and updating tasks, and checking auth status.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that connects AI assistants to TickTick, enabling project and task management through natural language, including reading projects, finding tasks, creating tasks, and completing work.2MIT