MCP.so
Sign In

TickTick MCP Server

@alexarevalo9

Repository

About TickTick MCP Server

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

#node#mcp#artif

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

18

`projectId` (string): Project identifier

Task object matching `TickTickTaskSchema`

`title` (string): Task title

Created task object matching `TickTickTaskSchema`

`taskId` (string): Task identifier - Path

Updated task object matching `TickTickTaskSchema`

`taskId` (string): Task identifier

void

`taskId` (string): Task identifier

void

None

Array of project objects matching `TickTickProjectSchema`

`projectId` (string): Project identifier

Project object matching `TickTickProjectSchema`

`projectId` (string): Project identifier

Object containing:

`name` (string): Project name

Created project object matching `TickTickProjectSchema`

Overview

What is TickTick MCP Server?

A Model Context Protocol server that integrates with the TickTick API, enabling task management, project organization, habit tracking, and more through AI assistants. It provides tools for creating, reading, updating, and deleting tasks and projects with full OAuth authentication.

How to use TickTick MCP Server?

Configure OAuth credentials (TICKTICK_CLIENT_ID and TICKTICK_CLIENT_SECRET) and an access token using a .env file or terminal environment variables. Run the MCP server via NPX (npx @alexarevalo.ai/mcp-server-ticktick) or Docker. For Claude Desktop, add the server configuration to claude_desktop_config.json. First-time authorization requires running an auth command to generate an access token.

Key features of TickTick MCP Server

  • Task Management: Create, read, update, and delete tasks with all properties
  • Project Management: Create, read, update, and delete projects with customizable views
  • Subtask Support: Full management of 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

Use cases of TickTick MCP Server

  • Manage TickTick tasks and projects directly from an AI chat interface
  • Automate task creation with due dates, reminders, and recurring rules
  • Organize and update project views (list, kanban, timeline) and kinds (TASK, NOTE)
  • Track habits and subtasks within the TickTick ecosystem

FAQ from TickTick MCP Server

How do I install TickTick MCP Server?

You can install it via NPX, Docker, or automatically via Smithery using the command npx -y @smithery/cli install @alexarevalo9/ticktick-mcp-server --client claude.

How do I authenticate with TickTick?

Register an app on the TickTick Developer Portal, set the OAuth redirect URL to http://localhost:8000/callback, then run the auth command (npx @alexarevalo.ai/mcp-server-ticktick ticktick-auth) to obtain an access token that must be set as an environment variable.

What are the priority levels and status values?

Priority can be 0 (None), 1 (Low), 3 (Medium), or 5 (High). Status values are 0 (Normal/not completed) and 2 (Completed).

What format do dates and reminders use?

Dates follow ISO 8601 format (yyyy-MM-dd'T'HH:mm:ssZ). Reminders use iCalendar TRIGGER format (e.g., ["TRIGGER:P0DT9H0M0S"]). Recurring rules use RFC 5545 (e.g., "RRULE:FREQ=DAILY;INTERVAL=1").

How do I use TickTick MCP Server with Claude Desktop?

Add a ticktick entry to claude_desktop_config.json under mcpServers with command npx and args ["-y", "@alexarevalo.ai/mcp-server-ticktick"], along with the required environment variables for OAuth.

Frequently asked questions

How do I install TickTick MCP Server?

You can install it via NPX, Docker, or automatically via Smithery using the command `npx -y @smithery/cli install @alexarevalo9/ticktick-mcp-server --client claude`.

How do I authenticate with TickTick?

Register an app on the TickTick Developer Portal, set the OAuth redirect URL to `http://localhost:8000/callback`, then run the auth command (`npx @alexarevalo.ai/mcp-server-ticktick ticktick-auth`) to obtain an access token that must be set as an environment variable.

What are the priority levels and status values?

Priority can be 0 (None), 1 (Low), 3 (Medium), or 5 (High). Status values are 0 (Normal/not completed) and 2 (Completed).

What format do dates and reminders use?

Dates follow ISO 8601 format (`yyyy-MM-dd'T'HH:mm:ssZ`). Reminders use iCalendar TRIGGER format (e.g., `["TRIGGER:P0DT9H0M0S"]`). Recurring rules use RFC 5545 (e.g., `"RRULE:FREQ=DAILY;INTERVAL=1"`).

How do I use TickTick MCP Server with Claude Desktop?

Add a `ticktick` entry to `claude_desktop_config.json` under `mcpServers` with command `npx` and args `["-y", "@alexarevalo.ai/mcp-server-ticktick"]`, along with the required environment variables for OAuth.

Comments

Basic information

Category

Productivity

Transports

stdio

Author

alexarevalo9

More Productivity MCP servers

Computer Control MCP

AB498

MCP server that provides computer control capabilities, like mouse, keyboard, OCR, etc. using PyAutoGUI, RapidOCR, ONNXRuntime. Similar to 'computer-use' by Anthropic. With Zero External Dependencies.

150

AdWhispr - Research, Clone, & Launch Ads from Claude/ChatGPT

AdWhispr

Remote MCP server that turns Claude, ChatGPT, or Cursor into a full ad workflow: research any brand's live Facebook and TikTok ads, clone the proven winners for your own brand, and launch real campaigns on Google, TikTok

MCP Shrimp Task Manager

cjo4m06

Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought, reflection, and style consistency. It converts natural language into structured dev tasks with dependency tracking and iterative refinement, enabling agent-like developer behavior in reasoning A

2.1K

AppleScript MCP Server (Dual access: python and node.js)

peakmojo

MCP server that execute applescript giving you full control of your Mac

461

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

yokingma

⏰ Time MCP Server: Giving LLMs Time Awareness Capabilities

67