Ticktick-MCP-Enhanced

@Code-MonkeyZhang

About Ticktick-MCP-Enhanced

A Model Context Protocol (MCP) server that allows you to manage your daily routine TickTick tasks with LLMs!

#ticktick #task-management #llm-integration

Config

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

{
  "mcpServers": {
    "ticktick": {
      "command": "<absolute path to uv>",
      "args": [
        "run",
        "--directory",
        "<absolute path to ticktick-mcp directory>",
        "-m",
        "ticktick_mcp.cli",
        "run"
      ]
    }
  }
}

Tools

`get_all_projects`

`create_tasks`

`query_tasks`

Overview

What is Ticktick-MCP-Enhanced?

Ticktick-MCP-Enhanced is a Model Context Protocol (MCP) server that enables LLMs like Claude to manage TickTick tasks and projects via natural language. It provides full API coverage, batch operations, and inbox access for developers and users who want AI-driven task management.

How to use Ticktick-MCP-Enhanced?

Install Python 3.10+ and uv, clone the repo, create and activate a venv, then run uv pip install -e . and uv run -m ticktick_mcp.cli auth for authentication. Configure Claude Desktop by adding the server to claude_desktop_config.json with the command uv run --directory <path> -m ticktick_mcp.cli run.

Key features of Ticktick-MCP-Enhanced

Complete TickTick API coverage with all task parameters
Access inbox tasks with special project ID "inbox"
Correct timezone handling for due dates
Batch operations for create, update, delete, complete
10 unified MCP tools for projects, tasks, and queries

Use cases of Ticktick-MCP-Enhanced

Manage daily tasks and projects via natural language with AI
Batch create multiple tasks or subtasks from a single command
Filter and query tasks by priority, date, or search term
View and update TickTick inbox and project details
Automate task completion and project deletion workflows

FAQ from Ticktick-MCP-Enhanced

What does this MCP server do compared to alternatives?

It is an enhanced version of the original ticktick-mcp with complete API coverage, inbox access, timezone fixes, batch operations, and a simplified tool set.

What are the runtime requirements?

Python 3.10 or higher and the uv package manager. A TickTick account with registered API credentials (Client ID and Client Secret) is required.

Where does my data live?

The server interacts with TickTick’s cloud API; authentication tokens are saved locally in a .env file. No data is stored by the server itself beyond the token.

Are there any known limitations or restrictions?

The README does not mention specific limits, but batch operations are supported and the tool set is simplified for ease of use. It uses OAuth authentication with a redirect URI of http://localhost:8000/callback.

What transports or authentication methods are used?

The server uses MCP standard transport and OAuth 2.0 authentication via TickTick’s developer portal. Configuration is done through environment variables and a local auth flow.

Frequently asked questions