TickTick MCP Server
@alexarevalo9
About TickTick MCP Server
A Model Context Protocol (MCP) server designed to integrate with the TickTick task management platform, enabling intelligent context-aware task operations and automation.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"ticktick": {
"command": "npx",
"args": [
"-y",
"@alexarevalo.ai/mcp-server-ticktick"
],
"env": {
"TICKTICK_CLIENT_ID": "<YOUR_CLIENT_ID>",
"TICKTICK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"TICKTICK_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
}
}
}
}Tools
16Get all user projects
Get a project by ID
Get a project with its tasks and columns
Create a new project
Update an existing project
Delete a project
Get a task by ProjectId and TaskId
Create a new task
Update an existing task
Complete a task
Delete a task
Get completed tasks across all projects within a date range
Batch create, update, and/or delete multiple tasks in a single request
Get all subtasks of a parent task by fetching project data and filtering by parentId
Get the current authenticated user profile
Get tasks from the inbox (resolves inbox project ID automatically from user profile)
Overview
What is TickTick MCP Server?
A Model Context Protocol server that integrates with the TickTick API, enabling task management, project organization, habit tracking, and more through AI assistants. It provides tools for creating, reading, updating, and deleting tasks and projects with full OAuth authentication.
How to use TickTick MCP Server?
Configure OAuth credentials (TICKTICK_CLIENT_ID and TICKTICK_CLIENT_SECRET) and an access token using a .env file or terminal environment variables. Run the MCP server via NPX (npx @alexarevalo.ai/mcp-server-ticktick) or Docker. For Claude Desktop, add the server configuration to claude_desktop_config.json. First-time authorization requires running an auth command to generate an access token.
Key features of TickTick MCP Server
- Task Management: Create, read, update, and delete tasks with all properties
- Project Management: Create, read, update, and delete projects with customizable views
- Subtask Support: Full management of subtasks within parent tasks
- Complete Task Control: Set priorities, due dates, reminders, and recurring rules
- OAuth Authentication: Full OAuth2 implementation for secure API access
- Comprehensive Error Handling: Clear error messages for common issues
Use cases of TickTick MCP Server
- Manage TickTick tasks and projects directly from an AI chat interface
- Automate task creation with due dates, reminders, and recurring rules
- Organize and update project views (list, kanban, timeline) and kinds (TASK, NOTE)
- Track habits and subtasks within the TickTick ecosystem
FAQ from TickTick MCP Server
How do I install TickTick MCP Server?
You can install it via NPX, Docker, or automatically via Smithery using the command npx -y @smithery/cli install @alexarevalo9/ticktick-mcp-server --client claude.
How do I authenticate with TickTick?
Register an app on the TickTick Developer Portal, set the OAuth redirect URL to http://localhost:8000/callback, then run the auth command (npx @alexarevalo.ai/mcp-server-ticktick ticktick-auth) to obtain an access token that must be set as an environment variable.
What are the priority levels and status values?
Priority can be 0 (None), 1 (Low), 3 (Medium), or 5 (High). Status values are 0 (Normal/not completed) and 2 (Completed).
What format do dates and reminders use?
Dates follow ISO 8601 format (yyyy-MM-dd'T'HH:mm:ssZ). Reminders use iCalendar TRIGGER format (e.g., ["TRIGGER:P0DT9H0M0S"]). Recurring rules use RFC 5545 (e.g., "RRULE:FREQ=DAILY;INTERVAL=1").
How do I use TickTick MCP Server with Claude Desktop?
Add a ticktick entry to claude_desktop_config.json under mcpServers with command npx and args ["-y", "@alexarevalo.ai/mcp-server-ticktick"], along with the required environment variables for OAuth.
Frequently asked questions
How do I install TickTick MCP Server?
You can install it via NPX, Docker, or automatically via Smithery using the command `npx -y @smithery/cli install @alexarevalo9/ticktick-mcp-server --client claude`.
How do I authenticate with TickTick?
Register an app on the TickTick Developer Portal, set the OAuth redirect URL to `http://localhost:8000/callback`, then run the auth command (`npx @alexarevalo.ai/mcp-server-ticktick ticktick-auth`) to obtain an access token that must be set as an environment variable.
What are the priority levels and status values?
Priority can be 0 (None), 1 (Low), 3 (Medium), or 5 (High). Status values are 0 (Normal/not completed) and 2 (Completed).
What format do dates and reminders use?
Dates follow ISO 8601 format (`yyyy-MM-dd'T'HH:mm:ssZ`). Reminders use iCalendar TRIGGER format (e.g., `["TRIGGER:P0DT9H0M0S"]`). Recurring rules use RFC 5545 (e.g., `"RRULE:FREQ=DAILY;INTERVAL=1"`).
How do I use TickTick MCP Server with Claude Desktop?
Add a `ticktick` entry to `claude_desktop_config.json` under `mcpServers` with command `npx` and args `["-y", "@alexarevalo.ai/mcp-server-ticktick"]`, along with the required environment variables for OAuth.
Basic information
More Productivity MCP servers
One
OneConnect your agent to the apps your team already uses: Gmail, Slack, Stripe, Shopify, HubSpot, Notion, Linear, Salesforce, QuickBooks and more. One hosted MCP server with OAuth sign-in, nothing to install and no API keys
crosscode-cli
amsultan2010Multiplayer coding in the agentic era through an MCP server for real-time codebase sync between your agents.
Etincel
AIStoryHubFind the AI tells in your prose. Deterministic, local, runs in CI. MCP server + CLI + Action.
Dadan MCP
Dadan-iodadan-sdk-integration is an SDK for integrating Dadan features into React applications. It allows you to add video recording and file selection functionality directly into your React components, providing a seamless user
RADAAR
RADAARThe RADAAR MCP (Model Context Protocol) Server acts as a bridge between AI assistants (such as Claude, ChatGPT, or custom LLM agents) and the RADAAR social media management platform. By exposing RADAAR’s core tools and A
Comments