Advertise
MCP.so
Sign In

TickTick MCP Server

@alexarevalo9

Repository

Basic information

Category

Productivity

Transports

stdio

Author

alexarevalo9

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

TickTick MCP Server 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>"
      }
    }
  }
}

TickTick MCP Server tools

16

Get all user projects

Get a project by ID

Get a project with its tasks and columns

Create a new project

Update an existing project

Delete a project

Get a task by ProjectId and TaskId

Create a new task

Update an existing task

Complete a task

Delete a task

Get completed tasks across all projects within a date range

Batch create, update, and/or delete multiple tasks in a single request

Get all subtasks of a parent task by fetching project data and filtering by parentId

Get the current authenticated user profile

Get tasks from the inbox (resolves inbox project ID automatically from user profile)

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

Frequently asked questions

1

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

2

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.

3

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

4

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"`).

5

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

More Productivity MCP servers

Mailercloud

Mailercloud

Connect AI assistants to Mailercloud, the email marketing platform — manage campaigns, contacts, lists, templates, and sending, plus AI-powered campaign analysis and deliverability audits. Endpoint: https://mcp.mailerclo

AgentGrid.io (by Anima)

Anima

Shared workspace for humans and AI agents by Anima. Create, version, publish, and share live apps, docs, and files from any agent, with per-agent access control. Support all types of agents: Grok Bot, Muse AI, OpenAI Dot

Nilyo

Your own LinkedIn, WhatsApp, Instagram, Telegram, Email and Calendar accounts, usable from any agent — search, read and act on your own accounts.

V

Vokolla Press Release Agent

Vokolla

Bring Vokolla’s all-in-one press release workflow into your AI conversation. Draft and refine English or Chinese releases with AI, compare distribution packages, save account drafts and track release progress and publica

mxHERO Mail2Cloud Advanced — Enterprise Email Search

mxHERO Inc.

Governed, read-only AI access to your enterprise email archive. Search years of correspondence across teams and mail systems in plain language.

Advertise