home / mcp / ticktick mcp server

TickTick MCP Server

Provides MCP endpoints and tooling to manage TickTick tasks, projects, and related data via OAuth-secured access.

Installation

Add the following to your MCP client configuration file.

Configuration

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

The TickTick MCP Server lets you interact with TickTick data through programmatic endpoints. You can manage tasks and projects, handle subtasks, set reminders and priorities, and authenticate securely using OAuth, all from your MCP client. This guide shows you how to use the server, install it, and configure it for smooth operation.

How to use

You will connect to the TickTick MCP Server from your MCP client to manage tasks and projects. The server exposes a set of functions that cover creating, reading, updating, completing, and deleting tasks; managing projects and their data; and retrieving user-specific projects. You can also authenticate via OAuth to securely access TickTick data. Use the provided MCP configurations to run the server locally via standard tools like npx or Docker, or connect to a remote MCP service if your setup provides one.

How to install

# Prerequisites
- Node.js installed (LTS version recommended)
- NPM or Yarn for package management
- Docker if you plan to run the Docker image

# Option A: Run via NPX (recommended for quick start)
npx -y @alexarevalo.ai/mcp-server-ticktick ticktick-auth

# Option B: Run via Docker (requires Docker)
docker run -i --rm -e TICKTICK_CLIENT_ID -e TICKTICK_CLIENT_SECRET -e TICKTICK_ACCESS_TOKEN mcp/ticktick

# After authentication, you will obtain an access token to configure your client

Configuration and usage notes

OAuth authentication is required to access TickTick data. Register your application on the TickTick Developer Portal, obtain a client ID and client secret, and perform the authentication flow to generate an access token. Store sensitive credentials securely using an environment file or system environment variables.

Available tools

get_task_by_ids

Retrieve a specific task by its project ID and task ID. Requires projectId and taskId and returns a task object matching TickTickTaskSchema.

create_task

Create a new task in a project with optional content, dates, reminders, and subtasks. Returns the created task object.

update_task

Update an existing task by taskId and projectId with optional fields from create_task. Returns the updated task object.

complete_task

Mark a task as completed by taskId and projectId. Returns void.

delete_task

Delete a task from a project by taskId and projectId. Returns void.

get_user_projects

Fetch all projects for the authenticated TickTick user. Returns an array of project objects.

get_project_by_id

Retrieve a specific project by its projectId. Returns a project object.

get_project_with_data

Get project details along with related tasks and optional columns. Returns an object with project, tasks, and columns.

create_project

Create a new project with name, color, viewMode, and kind. Returns the created project object.

update_project

Update an existing project by projectId with optional fields. Returns the updated project object.

delete_project

Delete a project by projectId. Returns void.