Ticktick
TickTick is a cross-platform task management and to-do list application designed to help users organize their tasks and schedules efficiently.
Verdict
Common use cases
- Log action items from meeting notes
- Archive completed tasks after sprint review
- Pull today's task list into standup chat
- Create project scaffolds from brainstorm sessions
- Mark tasks done as team confirms progress
Integration
- Vendor
- Ticktick
- Category
- productivity
- Auth
- OAUTH2
- Tools
- 13
- Composio slug
ticktick
Tools
- Complete Task
Tool to mark a task as complete. use after confirming the task is done.
- Complete Task
Tool to mark a specific task as complete. use after confirming the task is done.
- Create Project
Tool to create a new project in ticktick. use when you need to programmatically add a project after obtaining a valid access token.
- Create Task
Tool to create a new task in ticktick. use after you have task details such as title, dates, and optional reminders or subtasks.
- Delete Taskdestructive
Tool to delete a specific task. use when you need to remove a task from a project after confirming both project and task ids.
- Delete TickTick Projectdestructive
Tool to delete a specific project. use when you have confirmed the project id and intend to permanently remove it. example: "delete the project with id 6226ff9877acee87727f6bca".
- Generate OAuth2 Authorization URL
Tool to generate the ticktick oauth2 authorization url. use to redirect the user to obtain the authorization code (step 1).
- Get project with data
Tool to retrieve a project and its associated data (tasks, columns). use when you need full project details including its tasks and columns after selecting a project id.
- Get User Projects
Tool to retrieve all projects for the user. use when you need to list available projects for selection.
- Redirect to TickTick OAuth2 authorization page
Tool to redirect user to ticktick authorization page to obtain authorization code. use when initiating the oauth2 flow before exchanging the code.
- Update Project
Tool to update an existing project. use when you need to modify project details like name, color, sort order, view mode, or kind after selecting a project id.
- Update Project
Tool to update an existing project. use when you need to modify project details like name, color, sort order, view mode, or kind after selecting a project id.
- Update Task
Tool to update an existing task. use after confirming the taskid and projectid.
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the MCP Integrations tab. 2. Find TickTick in the list and click Connect. 3. You'll be redirected to TickTick's OAuth consent screen — log in with your TickTick credentials and authorize Switchy to read and write tasks and projects. 4. After granting permission, you'll return to Switchy with the connection active. 5. Open any Space and type '@TickTick' to confirm the integration appears in the mention menu. 6. Test it by asking '@TickTick create a task called Test task in my Inbox' — if the task appears in your TickTick account, you're ready. 7. To invoke tools, always start your message with '@TickTick' followed by your request in plain language.
What teammates see: by default, memories from Ticktick are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Log Meeting Actions
@TickTick review the meeting notes above and create a task for each action item, using the person's name as the task title and the due date mentioned.Open in a Space →
Daily Task Briefing
@TickTick show me all tasks due today in the 'Q1 Launch' project, grouped by assignee.Open in a Space →
Archive Completed Work
@TickTick mark these tasks as complete: 'Finalize design specs', 'Review PR #42', 'Update changelog'.Open in a Space →
Scaffold New Project
@TickTick create a project called 'Website Redesign' and add tasks for wireframes, content audit, dev setup, and QA checklist.Open in a Space →
Check Task Status
@TickTick get the full task list for the 'Marketing Campaign' project and tell me which tasks are still open.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Ticktick show me all tasks due this week across my projects, grouped by priority
Here's what's due this week: **High Priority (3 tasks)** - Finish Q1 budget review (Marketing project, due Wed) - Submit vendor contracts (Operations, due Fri) - Review design mockups (Product Launch, due Thu) **Medium Priority (5 tasks)** - Update team wiki (Internal Docs, due Tue) - Schedule client calls (Sales Pipeline, due Wed) - Three additional tasks in Development project **Low Priority (2 tasks)** - Organize shared drive (Admin, due Sat) - Update contact list (CRM Cleanup, due Sun) This example illustrates fetching tasks with date and priority filters across multiple projects.
This read-heavy example demonstrates the MCP's ability to aggregate task data across projects with filtering. Requires OAuth2 scope for reading all projects and tasks. The actual response structure depends on how your TickTick account organizes priorities and projects—some users may see different priority labels or project structures.
@Ticktick create a task 'Review API documentation' in my Development project, due Friday with a reminder 2 hours before
Task created successfully: **Review API documentation** - Project: Development - Due: Friday, January 17, 2025 at 5:00 PM - Reminder: Friday at 3:00 PM - Status: Open - Task ID: 67a3f8b2c4e9d1a2b3c4d5e6 This example shows the MCP creating a task with title, project assignment, due date, and reminder configuration. The task is now visible in your TickTick workspace.
This write example showcases task creation with multiple parameters. Requires OAuth2 write permissions. The MCP needs a valid project ID—if you reference a project by name, the integration must first resolve it to an ID. Side-effect: immediately creates a live task in your TickTick account, so confirm details before executing.
@Ticktick look at my 'Product Launch' project and draft a status update email summarizing completed vs. remaining tasks
Based on your Product Launch project: **Draft Status Update:** Team— We've completed 12 of 18 tasks (67%) for the Product Launch. Key accomplishments this week: finalized landing page copy, completed user testing round 2, and locked pricing tiers. Remaining work (6 tasks): - High priority: Press release draft (due Mon), app store screenshots (due Wed) - Medium priority: Support docs, FAQ page, analytics setup - Low priority: Social media calendar We're on track for the Jan 24 launch if the two high-priority items close by midweek. This example combines TickTick data retrieval with AI synthesis to generate a narrative summary.
This synthesis example pairs the MCP's project data fetch with the AI's summarization capabilities. The AI interprets task completion status, due dates, and priorities to generate prose—useful for standups or stakeholder updates. Accuracy depends on your task metadata quality (clear titles, accurate due dates). The MCP provides raw data; the AI adds interpretation.
Use-case deep-dives
When TickTick MCP works for async standup updates
A 6-person engineering team runs async standups in Slack and uses TickTick to track sprint tasks. The MCP's Complete Task and Create Task tools let a bot parse standup messages and update TickTick without anyone leaving Slack. This works if your team already lives in TickTick and your standup format is predictable (blockers, done items, next tasks). The OAuth2 flow means each dev authorizes once, then the bot acts on their behalf. The threshold: if your team uses Linear or Jira for sprint tracking, this MCP creates a sync problem—you'll end up with two sources of truth. Use this when TickTick is already your single task system and you want to eliminate the tab-switching tax during standups.
How TickTick MCP handles new client onboarding workflows
A 12-person creative agency gets 3-5 new client projects per month. The MCP's Create Project and Create Task tools let an intake bot spin up a TickTick project from a Typeform submission—pre-populate discovery tasks, set due dates, assign the account lead. This saves 20 minutes per intake and eliminates the 'forgot to create the project' failure mode. The catch: TickTick's project structure is flat, so if your agency runs complex multi-phase engagements with nested workstreams, you'll hit the organizational ceiling fast. Use this if your projects are straightforward (under 50 tasks each) and your intake process is templatized. If you need Gantt charts or dependencies, the MCP won't cover it—you're shopping for Asana or Monday.
When TickTick MCP automates weekly review routines
A solo consultant runs a Friday afternoon GTD review: archive completed tasks, reschedule overdue items, create next week's priorities. The MCP's Get project with data and Complete Task tools let a Shortcuts or Zapier workflow pull the week's task list, surface what's stale, and batch-complete or reschedule based on simple rules. This works if you're disciplined about tagging and due dates—the MCP can't infer priority or context from messy task titles. The 13-tool scope is overkill for most solopreneurs (you'll use 4-5 tools max), but the OAuth2 setup is one-time pain for ongoing convenience. Use this if you're already a TickTick power user and your review process is mechanical enough to script. If your review involves judgment calls on every task, keep it manual.
Frequently asked
What does the TickTick MCP let me do in Switchy?
It connects your TickTick account so AI agents can create tasks, mark them complete, manage projects, and read your existing task lists. You can ask an agent to add a task with a due date and reminders, delete finished projects, or pull all tasks from a specific project to summarise what's left. The MCP handles 13 different TickTick operations without leaving Switchy.
Do I need admin access to connect TickTick via OAuth?
No. TickTick uses personal OAuth tokens, so any team member with a TickTick account can connect their own workspace. The MCP will only access projects and tasks visible to that user. If your team shares a TickTick Premium account, whoever owns the login should connect it to avoid permission gaps.
Can the MCP move tasks between TickTick projects or change priority levels?
The current tool set focuses on create, complete, and delete operations. Moving a task between projects isn't exposed as a direct tool, so you'd need to delete the old task and recreate it in the target project. Priority and tag updates aren't listed in the available tools either—stick to the TickTick app for those edits.
Why use the MCP instead of just opening TickTick or calling its API?
The MCP lets AI agents act on your tasks in the same conversation where you're planning work or reviewing notes. You don't context-switch to another app or write API scripts. If you already have custom TickTick automations via Zapier or code, those still work—the MCP is for ad-hoc, conversational task management inside Switchy.
Who on my team should connect the TickTick integration?
Whoever manages the shared task lists your team references in Switchy. If each person tracks their own TickTick projects, they can each connect their account. The OAuth token is per-user, so one connection won't give the whole team access to someone else's personal tasks unless you share a single TickTick login.