MCP.so
Sign In

TickTick MCP Server

@jacepark12

Repository

About TickTick MCP Server

MCP server that interacts with TickTick (Dida 365) via the TickTick Open API

#mcp-ticktick#task-management#mcp-server

Basic information

Category

Other

Runtime

python

Transports

stdio

Publisher

jacepark12

Config

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

{
  "mcpServers": {
    "ticktick-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is TickTick MCP Server?

A Model Context Protocol server that lets you manage your TickTick tasks and projects directly through Claude or any other MCP client, using TickTick’s open API.

How to use TickTick MCP Server?

Install the package with uv, run the OAuth2 authentication command (uv run -m ticktick_mcp.cli auth), and configure Claude for Desktop by adding the server entry to claude_desktop_config.json. Once connected, MCP tools become available in the client.

Key features of TickTick MCP Server

  • View all TickTick projects and tasks
  • Create, update, complete, and delete tasks
  • Create and delete projects
  • Search tasks by title, content, or subtasks
  • Filter tasks by priority, due date, or overdue status
  • Batch-create multiple tasks at once

Use cases of TickTick MCP Server

  • List projects and tasks, then ask for details or next steps
  • Create a new task with a specific priority and due date using natural language
  • Check what tasks are due today, tomorrow, or this week
  • Search for tasks containing a given keyword
  • Apply a GTD workflow: identify engaged and next actions, then break down work

FAQ from TickTick MCP Server

What are the prerequisites?

Python 3.10 or higher, uv (fast package installer), and a TickTick account with API credentials (Client ID, Client Secret, Access Token).

How does authentication work?

The server uses OAuth2. Running uv run -m ticktick_mcp.cli auth opens a browser to authorize your account, then automatically saves the tokens in a .env file. Token refresh is handled automatically.

Can I use this with Dida365 (the Chinese version of TickTick)?

Yes. Set environment variables for the Dida365 API URLs before authentication, then follow the same OAuth2 steps.

Which MCP clients are supported?

The server works with any MCP client, including Claude for Desktop. Configuration requires adding the server to the client's MCP settings file.

How are my data and credentials stored?

API tokens are stored locally in a .env file. All task data resides on TickTick’s servers and is accessed via their official API.

Comments

More Other MCP servers

Production-ready MCP integrations for AI applications

Klavis-AI

Klavis AI: MCP integration platforms that let AI agents use tools reliably at any scale

5.8K

πŸš€ Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

Servers

modelcontextprotocol

Model Context Protocol Servers

88.2K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K