Tips

TickTick MCP: Connect AI to Your Task Manager

TickTick MCP: Connect AI to Your Task Manager

TickTick has an official MCP server - short for Model Context Protocol, the standard Anthropic introduced in late 2024 for letting AI assistants connect directly to external tools. With the TickTick MCP configured, an AI assistant like Claude can add tasks to your TickTick account, query your task lists, check what's due today, and mark items complete, all from a conversation or automated workflow.

This matters for how you interact with your task manager day-to-day. Instead of switching to TickTick to capture a task mid-conversation, you tell your AI assistant to add it. Instead of checking your task list manually before a planning session, you ask what's due and get a structured summary. It's one of the more practical productivity use cases for MCP because task management is exactly the kind of structured data retrieval and manipulation that AI tools handle well.

This guide covers how to set up the TickTick MCP server, what operations it supports, and how to get real value from it in your daily workflow. For context on TickTick itself, the TickTick review covers the broader feature set.



Key Takeaways

  • TickTick's official MCP server is available via npm and connects to your TickTick account using OAuth or an API token from your TickTick developer account.

  • Once configured in Claude Desktop (or another MCP-compatible AI tool), you can create, query, complete, and update tasks by talking to your AI assistant.

  • The most practical use cases are task capture during AI conversations, daily planning queries ("what's due today?"), and bulk task creation from planning sessions.



What Is MCP and Why It Matters for TickTick

Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external systems through a defined interface. Before MCP, AI tools could only work with information you explicitly pasted into the conversation. With MCP, an AI can read from and write to connected services - your calendar, your task manager, your code editor - in real time, within the conversation.

TickTick's MCP server exposes a set of tools that any MCP-compatible AI client can call. The AI doesn't have persistent access to your TickTick account; it can only perform actions when you're in an active conversation and ask it to. Each operation requires the AI to make a tool call that you can see and approve, depending on your permission settings.

The practical value: you're working in Claude on a project plan, you identify a list of action items, and instead of opening TickTick and adding them manually, you say "add all of these to my Work list in TickTick." The AI makes the tool calls and confirms the tasks were added. This reduces the friction of task capture from about 30 seconds per task (switch app, navigate to list, type, save) to near-zero. For people who do most of their thinking and planning in an AI assistant, this is meaningful.



How to Set Up TickTick MCP with Claude Desktop

Prerequisites: Claude Desktop installed, Node.js installed (the MCP server runs as a local Node.js process), and a TickTick account with API access enabled.

Step 1: Get your TickTick API credentials. Go to developer.ticktick.com, sign in with your TickTick account, and create a new application. This gives you a client ID and client secret for OAuth, or you can use a personal API token for simpler setups. The developer portal is straightforward - most users register a "personal use" application and get credentials within a few minutes.

Step 2: Install the TickTick MCP server. The official server is published to npm. Run this in your terminal:

  • npm install -g @anthropic/mcp-server-ticktick (or the community package at ticktick-mcp, depending on which version you're using - check the TickTick developer docs for the current recommended package)

Step 3: Configure Claude Desktop. Open your Claude Desktop configuration file - on Mac, this is at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows, it's %AppData%/Claude/claude_desktop_config.json. Add a TickTick entry to the mcpServers section:

  • "ticktick": {"command": "npx", "args": ["-y", "ticktick-mcp"], "env": {"TICKTICK_CLIENT_ID": "your-client-id", "TICKTICK_CLIENT_SECRET": "your-client-secret"}}

Step 4: Restart Claude Desktop. After restarting, you'll see TickTick listed in Claude's connected tools. The first time you use it, you may be prompted to authorize the OAuth connection in a browser window.



What You Can Do with TickTick MCP

The TickTick MCP server supports the core task management operations. Creating tasks: "Add 'Review Q4 budget' to my Work list due Friday" creates the task with the specified due date. Querying tasks: "What do I have due today?" returns your tasks organized by list. Completing tasks: "Mark the 'Send invoice' task as done" updates the task status. Getting projects/lists: the AI can fetch your list of TickTick lists to know where to put new tasks.

More sophisticated operations you can build on top of these: at the start of a planning session, ask Claude to show your tasks due this week organized by priority, then work through them conversationally, delegating some, adding context to others, and rescheduling as needed. At the end of a meeting where you've taken notes in Claude, ask it to extract all action items and add them to the appropriate TickTick lists with due dates.

The TickTick subtasks guide covers how subtasks work - MCP can create subtasks too, which makes it useful for decomposing tasks during AI-assisted project planning. The TickTick desktop app guide covers other ways to manage TickTick from a computer efficiently.



Setting Up TickTick MCP with Other AI Tools

MCP is a standard, so the TickTick MCP server works with any MCP-compatible AI tool, not just Claude Desktop. Cursor (the AI code editor) supports MCP servers, letting you manage tasks from within your coding environment. Zed editor also added MCP support. Any tool that implements the MCP client specification can use the TickTick server.

For non-Claude AI tools, the configuration steps vary but follow the same pattern: install the MCP server locally, provide your API credentials, and configure the tool to connect to the server. Check the specific tool's MCP documentation for the exact configuration format - it's usually a JSON config file similar to Claude Desktop's.

TickTick's API also supports standard REST integration for custom workflows. If you want to automate TickTick from scripts or other tools without MCP, the TickTick API documentation covers the REST endpoints. The apps that work with TickTick guide covers third-party integrations including Zapier and Make automations for non-AI automation use cases.



Limitations to Be Aware Of

The TickTick MCP server can create and manage tasks but it doesn't give the AI access to your whole account in a persistent way. Each conversation starts fresh. If you want the AI to understand your ongoing projects and priorities over time, you'd need to either share that context at the start of each conversation or build a workflow that queries your tasks to establish context automatically.

Rate limits apply to the TickTick API, so bulk operations (adding 50 tasks at once) may hit limits depending on your account tier. For typical conversational use - adding a handful of tasks, querying today's list, completing a few items - the limits are well above what normal use requires. The TickTick pricing guide clarifies what API access is available on free vs Premium plans.

Natural language date parsing via the AI can be inconsistent. "Due next Thursday" in the AI's output may land on a different date than you expect depending on how the AI interprets "next." Always review date assignments for tasks with important deadlines. The TickTick vs Todoist comparison covers how the two apps compare for natural language task input if that feature matters to you.



Beyond Task Capture: AI-Powered Scheduling

TickTick MCP solves the task capture problem well. The piece it doesn't address is what happens after tasks are in TickTick - deciding when to work on them based on your calendar availability and energy levels. Adding tasks via AI is fast; figuring out the best time to do each task still requires either manual calendar work or a tool built specifically for scheduling.

Lifestack app showing energy-aware scheduling and task management

Lifestack picks up where TickTick leaves off: it reads your task list and your calendar, understands your energy patterns, and auto-schedules tasks into time blocks during windows when you're genuinely available and focused. The result is that tasks captured quickly via TickTick MCP actually get scheduled for execution, not just captured and forgotten. The energy-based scheduling guide explains how this works, and the best AI planner apps guide covers the broader landscape of AI-powered task management. The Todoist and Lifestack integration guide covers a similar pattern for Todoist users. Lifestack is $9.99/month or $49.99/year with a 7-day free trial.



Frequently Asked Questions

Does TickTick have an official MCP server?

Yes. TickTick provides an official MCP server available through npm. There are also community-built MCP servers for TickTick with slightly different feature sets. The official server is the safest starting point since it's maintained by TickTick and uses their supported API surface. Check developer.ticktick.com for the current recommended setup.

Do I need a TickTick Premium account to use the MCP?

The TickTick API is accessible on both free and Premium accounts, though Premium accounts have higher API rate limits. For typical personal use through an AI assistant (a few dozen API calls per day), the free tier limits are sufficient. If you're building an automated workflow that makes many API calls, Premium limits are more appropriate.

Is MCP the same as TickTick's Zapier integration?

No. Zapier is an automation platform that connects TickTick to other apps through pre-built triggers and actions (e.g., "when a Trello card is moved, create a TickTick task"). MCP is specifically for AI assistants - it lets an AI make tool calls to TickTick within a conversation, in real time. The two serve different use cases: Zapier for automated, rule-based workflows; MCP for AI-assisted, conversational task management.

What happens to my TickTick data when I use MCP?

The MCP server runs locally on your machine and communicates directly with the TickTick API using your credentials. Your task data passes through the AI model only for the purpose of the specific operation you're requesting. The AI doesn't store your task data persistently. For tasks with sensitive content, be aware that the content passes through the AI's context window during operations - the same privacy consideration that applies to any data you share with an AI assistant.

Can I use TickTick MCP to automate daily planning?

Yes, as a manual daily ritual. At the start of your day, open Claude and ask it to fetch your tasks due today and this week, then work through planning conversationally - adjusting priorities, adding missing tasks, and delegating items. The AI can help you think through the plan rather than just showing you a list. This is different from automated scheduling (the AI doesn't block time on your calendar automatically), but it's a useful planning ritual for people who already use an AI assistant for daily work. The TickTick alternatives guide covers other apps if you're looking for deeper AI-native task management.

TickTick has an official MCP server - short for Model Context Protocol, the standard Anthropic introduced in late 2024 for letting AI assistants connect directly to external tools. With the TickTick MCP configured, an AI assistant like Claude can add tasks to your TickTick account, query your task lists, check what's due today, and mark items complete, all from a conversation or automated workflow.

This matters for how you interact with your task manager day-to-day. Instead of switching to TickTick to capture a task mid-conversation, you tell your AI assistant to add it. Instead of checking your task list manually before a planning session, you ask what's due and get a structured summary. It's one of the more practical productivity use cases for MCP because task management is exactly the kind of structured data retrieval and manipulation that AI tools handle well.

This guide covers how to set up the TickTick MCP server, what operations it supports, and how to get real value from it in your daily workflow. For context on TickTick itself, the TickTick review covers the broader feature set.



Key Takeaways

  • TickTick's official MCP server is available via npm and connects to your TickTick account using OAuth or an API token from your TickTick developer account.

  • Once configured in Claude Desktop (or another MCP-compatible AI tool), you can create, query, complete, and update tasks by talking to your AI assistant.

  • The most practical use cases are task capture during AI conversations, daily planning queries ("what's due today?"), and bulk task creation from planning sessions.



What Is MCP and Why It Matters for TickTick

Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external systems through a defined interface. Before MCP, AI tools could only work with information you explicitly pasted into the conversation. With MCP, an AI can read from and write to connected services - your calendar, your task manager, your code editor - in real time, within the conversation.

TickTick's MCP server exposes a set of tools that any MCP-compatible AI client can call. The AI doesn't have persistent access to your TickTick account; it can only perform actions when you're in an active conversation and ask it to. Each operation requires the AI to make a tool call that you can see and approve, depending on your permission settings.

The practical value: you're working in Claude on a project plan, you identify a list of action items, and instead of opening TickTick and adding them manually, you say "add all of these to my Work list in TickTick." The AI makes the tool calls and confirms the tasks were added. This reduces the friction of task capture from about 30 seconds per task (switch app, navigate to list, type, save) to near-zero. For people who do most of their thinking and planning in an AI assistant, this is meaningful.



How to Set Up TickTick MCP with Claude Desktop

Prerequisites: Claude Desktop installed, Node.js installed (the MCP server runs as a local Node.js process), and a TickTick account with API access enabled.

Step 1: Get your TickTick API credentials. Go to developer.ticktick.com, sign in with your TickTick account, and create a new application. This gives you a client ID and client secret for OAuth, or you can use a personal API token for simpler setups. The developer portal is straightforward - most users register a "personal use" application and get credentials within a few minutes.

Step 2: Install the TickTick MCP server. The official server is published to npm. Run this in your terminal:

  • npm install -g @anthropic/mcp-server-ticktick (or the community package at ticktick-mcp, depending on which version you're using - check the TickTick developer docs for the current recommended package)

Step 3: Configure Claude Desktop. Open your Claude Desktop configuration file - on Mac, this is at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows, it's %AppData%/Claude/claude_desktop_config.json. Add a TickTick entry to the mcpServers section:

  • "ticktick": {"command": "npx", "args": ["-y", "ticktick-mcp"], "env": {"TICKTICK_CLIENT_ID": "your-client-id", "TICKTICK_CLIENT_SECRET": "your-client-secret"}}

Step 4: Restart Claude Desktop. After restarting, you'll see TickTick listed in Claude's connected tools. The first time you use it, you may be prompted to authorize the OAuth connection in a browser window.



What You Can Do with TickTick MCP

The TickTick MCP server supports the core task management operations. Creating tasks: "Add 'Review Q4 budget' to my Work list due Friday" creates the task with the specified due date. Querying tasks: "What do I have due today?" returns your tasks organized by list. Completing tasks: "Mark the 'Send invoice' task as done" updates the task status. Getting projects/lists: the AI can fetch your list of TickTick lists to know where to put new tasks.

More sophisticated operations you can build on top of these: at the start of a planning session, ask Claude to show your tasks due this week organized by priority, then work through them conversationally, delegating some, adding context to others, and rescheduling as needed. At the end of a meeting where you've taken notes in Claude, ask it to extract all action items and add them to the appropriate TickTick lists with due dates.

The TickTick subtasks guide covers how subtasks work - MCP can create subtasks too, which makes it useful for decomposing tasks during AI-assisted project planning. The TickTick desktop app guide covers other ways to manage TickTick from a computer efficiently.



Setting Up TickTick MCP with Other AI Tools

MCP is a standard, so the TickTick MCP server works with any MCP-compatible AI tool, not just Claude Desktop. Cursor (the AI code editor) supports MCP servers, letting you manage tasks from within your coding environment. Zed editor also added MCP support. Any tool that implements the MCP client specification can use the TickTick server.

For non-Claude AI tools, the configuration steps vary but follow the same pattern: install the MCP server locally, provide your API credentials, and configure the tool to connect to the server. Check the specific tool's MCP documentation for the exact configuration format - it's usually a JSON config file similar to Claude Desktop's.

TickTick's API also supports standard REST integration for custom workflows. If you want to automate TickTick from scripts or other tools without MCP, the TickTick API documentation covers the REST endpoints. The apps that work with TickTick guide covers third-party integrations including Zapier and Make automations for non-AI automation use cases.



Limitations to Be Aware Of

The TickTick MCP server can create and manage tasks but it doesn't give the AI access to your whole account in a persistent way. Each conversation starts fresh. If you want the AI to understand your ongoing projects and priorities over time, you'd need to either share that context at the start of each conversation or build a workflow that queries your tasks to establish context automatically.

Rate limits apply to the TickTick API, so bulk operations (adding 50 tasks at once) may hit limits depending on your account tier. For typical conversational use - adding a handful of tasks, querying today's list, completing a few items - the limits are well above what normal use requires. The TickTick pricing guide clarifies what API access is available on free vs Premium plans.

Natural language date parsing via the AI can be inconsistent. "Due next Thursday" in the AI's output may land on a different date than you expect depending on how the AI interprets "next." Always review date assignments for tasks with important deadlines. The TickTick vs Todoist comparison covers how the two apps compare for natural language task input if that feature matters to you.



Beyond Task Capture: AI-Powered Scheduling

TickTick MCP solves the task capture problem well. The piece it doesn't address is what happens after tasks are in TickTick - deciding when to work on them based on your calendar availability and energy levels. Adding tasks via AI is fast; figuring out the best time to do each task still requires either manual calendar work or a tool built specifically for scheduling.

Lifestack app showing energy-aware scheduling and task management

Lifestack picks up where TickTick leaves off: it reads your task list and your calendar, understands your energy patterns, and auto-schedules tasks into time blocks during windows when you're genuinely available and focused. The result is that tasks captured quickly via TickTick MCP actually get scheduled for execution, not just captured and forgotten. The energy-based scheduling guide explains how this works, and the best AI planner apps guide covers the broader landscape of AI-powered task management. The Todoist and Lifestack integration guide covers a similar pattern for Todoist users. Lifestack is $9.99/month or $49.99/year with a 7-day free trial.



Frequently Asked Questions

Does TickTick have an official MCP server?

Yes. TickTick provides an official MCP server available through npm. There are also community-built MCP servers for TickTick with slightly different feature sets. The official server is the safest starting point since it's maintained by TickTick and uses their supported API surface. Check developer.ticktick.com for the current recommended setup.

Do I need a TickTick Premium account to use the MCP?

The TickTick API is accessible on both free and Premium accounts, though Premium accounts have higher API rate limits. For typical personal use through an AI assistant (a few dozen API calls per day), the free tier limits are sufficient. If you're building an automated workflow that makes many API calls, Premium limits are more appropriate.

Is MCP the same as TickTick's Zapier integration?

No. Zapier is an automation platform that connects TickTick to other apps through pre-built triggers and actions (e.g., "when a Trello card is moved, create a TickTick task"). MCP is specifically for AI assistants - it lets an AI make tool calls to TickTick within a conversation, in real time. The two serve different use cases: Zapier for automated, rule-based workflows; MCP for AI-assisted, conversational task management.

What happens to my TickTick data when I use MCP?

The MCP server runs locally on your machine and communicates directly with the TickTick API using your credentials. Your task data passes through the AI model only for the purpose of the specific operation you're requesting. The AI doesn't store your task data persistently. For tasks with sensitive content, be aware that the content passes through the AI's context window during operations - the same privacy consideration that applies to any data you share with an AI assistant.

Can I use TickTick MCP to automate daily planning?

Yes, as a manual daily ritual. At the start of your day, open Claude and ask it to fetch your tasks due today and this week, then work through planning conversationally - adjusting priorities, adding missing tasks, and delegating items. The AI can help you think through the plan rather than just showing you a list. This is different from automated scheduling (the AI doesn't block time on your calendar automatically), but it's a useful planning ritual for people who already use an AI assistant for daily work. The TickTick alternatives guide covers other apps if you're looking for deeper AI-native task management.

Download on the App Store
Get it on Google Play

FOLLOW ON

FOLLOW ON

FOLLOW ON

Copyright 2026 © Lifestack. All rights reserved

Copyright 2026 © Lifestack. All rights reserved

•

•

•

•

•

•

•