TickTick MCP Server

@rafliruslan

Repository

Basic information

About TickTick MCP Server

MCP server for TickTick integration

#ticktick #mcp-server #task-management

TickTick MCP Server config

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

{
  "mcpServers": {
    "ticktick-mcp-server-rafliruslan": {
      "command": "node",
      "args": [
        "oauth-helper.js"
      ]
    }
  }
}

TickTick MCP Server tools

Get all tasks or tasks from a specific project (with enhanced display)

Get overdue tasks with timezone compensation (configurable offset, defaults to UTC+8 - adjust for your timezone)

Get tasks due today with D+1 timezone adjustment

Get all projects from TickTick

Create a new task with priority, tags, due dates

Update an existing task

Delete a task

Mark a task as completed

Get a specific task by ID

Overview

What is TickTick MCP Server?

TickTick MCP Server is a Model Context Protocol (MCP) server that integrates AI assistants with the TickTick task management service. It enables listing, creating, updating, deleting, and completing tasks, managing projects, and handling timezone complexities—all through a standardized MCP interface.

How to use TickTick MCP Server?

Install dependencies with npm install, copy .env.example to .env, configure authentication (OAuth recommended or username/password), build with npm run build, then start with npm start. Integrate with MCP clients (e.g., Claude Desktop, Cursor IDE) by adding a server entry to their configuration file pointing to the built dist/index.js.

Key features of TickTick MCP Server

List tasks/projects with human‑readable priorities
Create, update, delete, and complete tasks
Get overdue tasks with configurable timezone offset
Get today’s tasks with automatic D+1 compensation
Supports OAuth and username/password authentication
Full TypeScript coverage with robust error handling

Use cases of TickTick MCP Server

Manage TickTick tasks directly from an AI chat interface
Automatically fetch overdue or today’s tasks with correct timezone
Create and update tasks with priorities, tags, and due dates
Integrate task management into Claude Desktop or Cursor workflows

Frequently asked questions

What authentication methods does TickTick MCP Server support?

It supports OAuth (recommended) via access/refresh tokens plus client credentials, and username/password authentication.

What runtime environment is required?

Node.js and npm are required. The server is built and run locally, then connected to MCP clients.

How does the server handle timezone differences?

It applies a manual D+1 adjustment to due dates and accepts a configurable `timezoneOffsetHours` parameter (default UTC+8) in `get_overdue_tasks` for accurate results.

Where are task data stored?

All data is stored in the remote TickTick cloud service; the server only acts as a bridge.

Which transport does the server use?

The server communicates via standard input/output (stdio) as an MCP subprocess, launched by a host like Claude Desktop or Cursor.

Comments

More Other MCP servers

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3