tickmcp
Provides tools for managing TickTick tasks and projects, including creating, updating, completing, and deleting tasks; managing projects; and handling checklist items.
Click on "Deploy 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., "@tickmcplist all my projects"
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.
tickmcp
This project is archived and no longer maintained. TickTick now provides anofficial MCP integration, which should be used instead.
Remote multi-user TickTick MCP server on Cloudflare Workers.
Streamable HTTP transport · OAuth 2.1 · Structured output
Connect
MCP endpoint: https://tickmcp.mrjl.dev/mcp
# Claude Code
claude mcp add tickmcp --transport http https://tickmcp.mrjl.dev/mcp
# Codex
codex mcp add tickmcp --url https://tickmcp.mrjl.dev/mcp{
"mcpServers": {
"tickmcp": {
"type": "streamableHttp",
"url": "https://tickmcp.mrjl.dev/mcp"
}
}
}ChatGPT — add as remote MCP server URL: https://tickmcp.mrjl.dev/mcp
Related MCP server: TickTick MCP Server
Tools
Tool | Description |
| Check TickTick connection status |
| List all projects |
| Get a project by ID |
| Create a project (supports |
| Update a project (supports |
| Permanently delete a project |
| Get project + undone tasks + columns envelope |
| List active tasks with filters (project, |
| Get a task by ID |
| Create a task (supports |
| Update a task (supports |
| Patch checklist items deterministically ( |
| Mark a task complete |
| Delete a task |
Current Limitation
ticktick_list_tasksintentionally supports active tasks only.status=2(completed listing) is explicitly unsupported and returnsVALIDATION_ERROR.
Architecture
MCP Client ←(OAuth 2.1)→ tickmcp ←(OAuth 2.0)→ TickTick APIRuntime: Cloudflare Workers
Transport: Streamable HTTP (
POST /mcp)Auth: OAuth 2.1 with consent screen + PKCE, proxying to TickTick OAuth 2.0
Storage: D1 (users, audit events, OAuth state) + KV (tokens, idempotency)
Rate limiting: Per-user via Cloudflare Rate Limiting
License
This server cannot be deployed
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
- mcpOAuthnet.todoist
Official Todoist MCP server for AI assistants to manage tasks, projects, and workflows.
Local-first task manager: create, edit, and complete tasks, projects, and checklists via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for TickTick API enabling task management, project organization, habit tracking, and more.44 npm73MIT
- FlicenseNot gradedqualityDmaintenanceRemote MCP server for managing TickTick tasks and projects, offering 22 tools for CRUD, search, and GTD workflows via any MCP client.1-
- AlicenseNot gradedqualityCmaintenanceA security-hardened MCP server for TickTick that enables managing your tasks directly through any MCP-compatible client.1MIT
- AlicenseNot gradedqualityCmaintenanceAn 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