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

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct