MCP.so
Sign In
T

Ticktick MCP Enhanced

@Code-MonkeyZhang

Basic information

Category

Other

Transports

stdio

Author

Code-MonkeyZhang

Submitted by

John Doe

About Ticktick MCP Enhanced

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

Ticktick MCP Enhanced 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"
      ]
    }
  }
}

Ticktick MCP Enhanced tools

3

`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

Frequently asked questions

1

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.

2

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.

3

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.

4

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`.

5

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.

Comments

More Other MCP servers