MCP.so
Sign In

TickTick MCP

@ekkyarmandi

About TickTick MCP

TickTick MCP for managing your To-Do using AI

Basic information

Category

Other

License

MIT license

Runtime

python

Transports

stdio

Publisher

ekkyarmandi

Config

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

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

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

FAQ from TickTick MCP

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.

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.

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.

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.

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