Ticktick Mcp Server

Name: Ticktick Mcp Server
Author: alexarevalo9

@alexarevalo9/ticktick-mcp-server · by alexarevalo9

A Model Context Protocol (MCP) server designed to integrate with the TickTick task management platform, enabling intelligent context-aware task operations and automation.

69 11 tools GitHub npm

No known CVEs

No license

Maintained

Last commit 86d ago

Works with most clients

Transport: stdio, http

11 tools · ~1.2k tok

Grade B · 0.6% of 200K ctx

Edit this pageView history

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ticktick": {
      "env": {
        "TICKTICK_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "TICKTICK_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "TICKTICK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      },
      "args": [
        "-y",
        "@alexarevalo.ai/mcp-server-ticktick"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/ticktick-mcp-server)](https://mcppedia.org/s/ticktick-mcp-server)

Read me

What Ticktick Mcp Server does

MCP Server for the TickTick API, enabling task management, project organization, habit tracking, and more.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y '@alexarevalo9/ticktick-mcp-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

79/100across 5 weighted dimensions

How we score →

0255075100

−21

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @alexarevalo9/ticktick-mcp-server against OSV.dev.

Inventory

Tools (11)

Click any tool to inspect its schema.

~1.2k tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Ticktick Mcp Server safe to use?: Ticktick Mcp Server has no known CVEs as of the latest MCPpedia security scan. It requires authentication to connect, which limits unauthorized access.
How do I install Ticktick Mcp Server?: Ticktick Mcp Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Ticktick Mcp Server do?: Ticktick Mcp Server provides 11 tools: get_task_by_ids, create_task, update_task, complete_task, delete_task and 6 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Ticktick Mcp Server?: Ticktick Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Ticktick Mcp Server actively maintained?: Ticktick Mcp Server is recently maintained — last commit was 86 days ago. It has 69 GitHub stars.

Similar servers

Others in productivity

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

85.9k 5

io.github.miroapp/mcp-server95

Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.

104 7

Scrumboy95

a self-hosted project management & Kanban solution + Instant shareable boards

238 1

Obsidian Local Llm Hub93

All-in-one local AI hub for Obsidian — LLM chat with vault tools, MCP servers, RAG, workflow automation, encryption, and edit history. Fully private, no cloud required.

40 11

MCP Security Weekly

Get CVE alerts and security updates for Ticktick Mcp Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "ticktick": { "env": { "TICKTICK_CLIENT_ID": "<YOUR_CLIENT_ID>", "TICKTICK_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>", "TICKTICK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>" }, "args": [ "-y", "@alexarevalo.ai/mcp-server-ticktick" ], "command": "npx" } } }

TickTick MCP Server

MCP Server for the TickTick API, enabling task management, project organization, habit tracking, and more.

Features

✅ Task Management: Create, read, update, and delete tasks with all available properties

📊 Project Management: Create, read, update, and delete projects with customizable views

📋 Subtask Support: Full support for managing 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

Tools

get_task_by_ids

Get a specific task by project ID and task ID
Inputs:
- projectId (string): Project identifier
- taskId (string): Task identifier
Returns: Task object matching TickTickTaskSchema

create_task

Create a new task in a project
Inputs:
- title (string): Task title
- projectId (string): Project id
- content (optional string): Task content
- desc (optional string): Task description
- isAllDay (optional boolean): Is all day task
- startDate (optional string): Task start date in "yyyy-MM-dd'T'HH:mm:ssZ" format
- dueDate (optional string): Task due date in "yyyy-MM-dd'T'HH:mm:ssZ" format
- timeZone (optional string): Task time zone (e.g., "America/Los_Angeles")
- reminders (optional string[]): List of reminder triggers in iCalendar format
- repeatFlag (optional string): Task repeat flag in iCalendar format
- priority (optional number): Task priority (None: 0, Low: 1, Medium: 3, High: 5)
- sortOrder (optional string): Task sort order
- items (optional array): List of subtasks with:
  - title (string): Subtask item title
  - startDate (optional string): Subtask date in "yyyy-MM-dd'T'HH:mm:ssZ" format
  - isAllDay (optional boolean): Is all day subtask item
  - sortOrder (optional number): Subtask item sort order
  - timeZone (optional string): Subtask timezone
  - status (optional number): Completion status (Normal: 0, Completed: 1)
  - completedTime (optional string): Completion time in "yyyy-MM-dd'T'HH:mm:ssZ" format
Returns: Created task object matching TickTickTaskSchema

update_task

Update an existing task
Inputs:
- taskId (string): Task identifier - Path
- id (string): Task identifier - Body
- projectId (string): Project id
- All optional fields from create_task
Returns: Updated task object matching TickTickTaskSchema

complete_task

Mark a task as completed
Inputs:
- taskId (string): Task identifier
- projectId (string): Project identifier
Returns: void

delete_task

Delete a task from a project
Inputs:
- taskId (string): Task identifier
- projectId (string): Project identifier
Returns: void

get_user_projects

Get all projects for the authenticated user
Inputs: None
Returns: Array of project objects matching TickTickProjectSchema

get_project_by_id

Get a specific project by ID
Inputs:
- projectId (string): Project identifier
Returns: Project object matching TickTickProjectSchema

get_project_with_data

Get project details along with tasks and columns
Inputs:
- projectId (string): Project identifier
Returns: Object containing:
- project: Project object matching TickTickProjectSchema
- tasks: Array of task objects matching TickTickTaskSchema
- columns: Optional array of column objects with:
  - id (optional string)
  - projectId (optional string)
  - name (optional string)

Frequently Asked Questions

Is Ticktick Mcp Server safe to use?

Ticktick Mcp Server has no known CVEs as of the latest MCPpedia security scan. It requires authentication to connect, which limits unauthorized access.

How do I install Ticktick Mcp Server?

Ticktick Mcp Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Ticktick Mcp Server do?

Ticktick Mcp Server provides 11 tools: get_task_by_ids, create_task, update_task, complete_task, delete_task and 6 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Ticktick Mcp Server?

Ticktick Mcp Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is Ticktick Mcp Server actively maintained?

Ticktick Mcp Server is recently maintained — last commit was 86 days ago. It has 69 GitHub stars.

TickTick MCP Server

MCP Server for the TickTick API, enabling task management, project organization, habit tracking, and more.

Features

✅ Task Management: Create, read, update, and delete tasks with all available properties

📊 Project Management: Create, read, update, and delete projects with customizable views

📋 Subtask Support: Full support for managing 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

Tools

get_task_by_ids

Get a specific task by project ID and task ID
Inputs:
- projectId (string): Project identifier
- taskId (string): Task identifier
Returns: Task object matching TickTickTaskSchema

create_task

Create a new task in a project
Inputs:
- title (string): Task title
- projectId (string): Project id
- content (optional string): Task content
- desc (optional string): Task description
- isAllDay (optional boolean): Is all day task
- startDate (optional string): Task start date in "yyyy-MM-dd'T'HH:mm:ssZ" format
- dueDate (optional string): Task due date in "yyyy-MM-dd'T'HH:mm:ssZ" format
- timeZone (optional string): Task time zone (e.g., "America/Los_Angeles")
- reminders (optional string[]): List of reminder triggers in iCalendar format
- repeatFlag (optional string): Task repeat flag in iCalendar format
- priority (optional number): Task priority (None: 0, Low: 1, Medium: 3, High: 5)
- sortOrder (optional string): Task sort order
- items (optional array): List of subtasks with:
  - title (string): Subtask item title
  - startDate (optional string): Subtask date in "yyyy-MM-dd'T'HH:mm:ssZ" format
  - isAllDay (optional boolean): Is all day subtask item
  - sortOrder (optional number): Subtask item sort order
  - timeZone (optional string): Subtask timezone
  - status (optional number): Completion status (Normal: 0, Completed: 1)
  - completedTime (optional string): Completion time in "yyyy-MM-dd'T'HH:mm:ssZ" format
Returns: Created task object matching TickTickTaskSchema

update_task

Update an existing task
Inputs:
- taskId (string): Task identifier - Path
- id (string): Task identifier - Body
- projectId (string): Project id
- All optional fields from create_task
Returns: Updated task object matching TickTickTaskSchema

complete_task

Mark a task as completed
Inputs:
- taskId (string): Task identifier
- projectId (string): Project identifier
Returns: void

delete_task

Delete a task from a project
Inputs:
- taskId (string): Task identifier
- projectId (string): Project identifier
Returns: void

get_user_projects

Get all projects for the authenticated user
Inputs: None
Returns: Array of project objects matching TickTickProjectSchema

get_project_by_id

Get a specific project by ID
Inputs:
- projectId (string): Project identifier
Returns: Project object matching TickTickProjectSchema

get_project_with_data

Get project details along with tasks and columns
Inputs:
- projectId (string): Project identifier
Returns: Object containing:
- project: Project object matching TickTickProjectSchema
- tasks: Array of task objects matching TickTickTaskSchema
- columns: Optional array of column objects with:
  - id (optional string)
  - projectId (optional string)
  - name (optional string)