Ticktick MCP server

Connect Ticktick to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy TicktickBook a demo

What you can do with the Ticktick MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the delete task tool in Ticktick
  • Use the delete project tool in Ticktick
  • Use the complete task tool in Ticktick
  • Use the get project tool in Ticktick
  • Use the get task tool in Ticktick
  • Use the batch tasks tool in Ticktick

Supported Tools

delete_task

Delete Task

Permanently delete a task from TickTick. Requires both the task ID and the project ID the task belongs to. This action cannot be undone.

delete_project

Delete Project

Permanently delete a project and all its tasks from TickTick. This action cannot be undone.

complete_task

Complete Task

Mark a task as complete in TickTick. Requires both the task ID and the project ID the task belongs to.

get_project

Get Project

Retrieve a project and optionally all its tasks and kanban columns. Use `includeTasks` to fetch the full project data with all associated tasks.

get_task

Get Task

Retrieve a specific task by its ID from TickTick, including all details such as subtasks, reminders, tags, and completion status.

batch_tasks

Batch Tasks

Create and update tasks in bulk, and delete tasks through individual requests. Operations are applied as they succeed; a later failure can leave earlier changes in place.

update_task

Update Task

Update an existing task in TickTick. Modify any combination of title, content, due dates, priority, tags, subtasks, recurrence, and reminders. Both the task ID and project ID are required.

create_task

Create Task

Create a new task in TickTick. Tasks can include subtasks (checklist items), reminders, recurrence rules, due dates, tags, and priority levels. Call list_projects to discover a project ID before creating tasks.

update_project

Update Project

Update an existing project's properties in TickTick. Modify the name, color, view mode, or kind.

get_user

Get User Profile

Retrieve the authenticated user's profile information from TickTick, including their user ID, name, and email.

create_project

Create Project

Create a new project (task list) in TickTick. Projects can be configured with a color, view mode (list, kanban, or timeline), and kind (TASK or NOTE).

list_projects

List Projects

List all projects (task lists) in the user's TickTick account. Returns project details including name, color, view mode, and permission level.

move_tasks

Move Tasks

Move one or more TickTick tasks from their current project to another project. Call list_projects to discover source and destination project IDs, and get_project with includeTasks to discover task IDs.

list_completed_tasks

List Completed Tasks

Retrieve completed TickTick tasks by project and completion-time range. Call list_projects to discover project IDs. Use filters to narrow the results.

search_tasks

Search Tasks

Find TickTick tasks by text, project, tags, completion status, and due dates. Call list_projects to discover project IDs when limiting the search to particular lists.

Connect Ticktick to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Ticktick in Metorial. In your Metorial portal, enable the Ticktick MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Ticktick tools.

Run Ticktick through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Ticktick and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Ticktick tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Ticktick

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Technical notes for Ticktick

Create, read, update, complete, and delete tasks and subtasks. Manage projects (task lists) and organize tasks with due dates, priorities, tags, reminders, and recurrence rules. Search tasks, retrieve completed tasks, move tasks between lists, and create or update tasks in bulk. Delete tasks individually or through a batch request. Retrieve project details with associated tasks and access user profile information.

Frequently asked questions

Common questions about connecting Ticktick to AI agents with Metorial.

  1. How many tools does the Ticktick MCP server have?
    The Ticktick MCP server exposes 15 tools, including Delete Task, Delete Project, Complete Task. Each one is governed and traced through Metorial.
  2. Ticktick exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Ticktick MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Ticktick and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Ticktick MCP server yourself or use the hosted gateway.

Connect Ticktick to production AI agents

See how Metorial gives your team governed access to Ticktick, with tracing and security controls built in.

Book a demoDeploy Ticktick