productivityoauth2

Ticktick

TickTick is a cross-platform task management and to-do list application designed to help users organize their tasks and schedules efficiently.

Verdict

The TickTick MCP connects your team's task management to Switchy's AI workspace. @mention it to create tasks, complete items, manage projects, and pull task lists into conversations — all without leaving the Space. Ideal for teams that already use TickTick for personal or shared to-dos and want AI to handle routine task updates during planning sessions or standups. Setup requires OAuth, so you'll grant read/write access to your TickTick account. The MCP can't handle recurring task logic or advanced filters, but it covers the core create-read-update-delete cycle for tasks and projects.

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 Task
    destructive

    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 Project
    destructive

    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

  1. 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

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

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.

Prompt

@Ticktick show me all tasks due this week across my projects, grouped by priority

Output

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.

Notes

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.

Prompt

@Ticktick create a task 'Review API documentation' in my Development project, due Friday with a reminder 2 hours before

Output

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.

Notes

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.

Prompt

@Ticktick look at my 'Product Launch' project and draft a status update email summarizing completed vs. remaining tasks

Output

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.

Notes

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

Standup task handoff for remote teams

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.

Client project intake for agencies

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.

Personal GTD review for solopreneurs

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.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.