Advertise
MCP.so
Sign In

TickTick MCP Server

@ekkyarmandi

Repository

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

ekkyarmandi

About TickTick MCP Server

TickTick MCP for managing your To-Do using AI

TickTick MCP Server config

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

{
  "mcpServers": {
    "ticktick-mcp-ekkyarmandi": {
      "command": "python",
      "args": [
        "main.py"
      ]
    }
  }
}

TickTick MCP Server tools

8

Get a list of all projects

Get details of a specific project

Get details of a specific task

Create a new project

Create a new task in a project

Update an existing task

Mark a task as complete

Delete a task

Overview

What is TickTick MCP?

TickTick MCP is a Model Context Protocol server that provides tools for integrating TickTick task management functionality. It enables AI assistants and applications to manage TickTick tasks and projects using natural language through a standardized interface.

How to use TickTick MCP?

Install dependencies with pip install -r requirements.txt, obtain a TickTick API key via OAuth through the TickTick developer portal, save the access token in a .env file as TICKTICK_API_KEY=your_token, and run python main.py to start the server on port 8000.

Key features of TickTick MCP

  • Retrieve a list of all projects and tasks
  • Create new projects and tasks in TickTick
  • Update details of existing tasks
  • Mark tasks as complete
  • Delete tasks from TickTick
  • Get details of a specific project or task

Use cases of TickTick MCP

  • Ask an AI assistant to show all your current projects
  • Have an AI create a new project and add tasks to it
  • Let an AI help you manage and update your daily to-do list
  • Use natural language to mark tasks as complete or delete them
  • Integrate TickTick task management into custom AI applications

Frequently asked questions

1

What are the requirements for TickTick MCP?

Python 3.8+, a TickTick account, and a TickTick API key obtained via OAuth through the TickTick developer portal.

2

How do I obtain a TickTick API key?

Register an app on the TickTick developer portal, get your Client ID and Client Secret, then use the ticktick-py library's OAuth2 class to authorize and retrieve an access token.

3

Where does TickTick MCP data live?

All task and project data lives on TickTick's servers, accessed via the TickTick OpenAPI. The MCP server does not store data locally.

4

What transport protocol does TickTick MCP use?

The MCP server runs on port 8000 and uses the Model Context Protocol. It works with any MCP-compatible client such as Claude Desktop or Cursor IDE.

5

How do I add new tools to TickTick MCP?

Add new tools in `tools.py` and register them in `main.py` using `mcp.add_tool()`.

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Advertise