TickTick MCP Server

Name: TickTick MCP Server
Author: rafliruslan

@rafliruslan

代码仓库

关于 TickTick MCP Server

MCP server for TickTick integration

#ticktick #mcp-server #task-management

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

rafliruslan

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

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

概览

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

FAQ from TickTick MCP Server

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.