TickTick MCP
About
TickTick MCP for managing your To-Do using AI
Details
- Author
- ekkyarmandi
- Downloads
- 195
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
TickTick MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ticktick mcp": {
"ticktick-mcp-ekkyarmandi": {
"command": "python",
"args": [
"main.py"
]
}
}
}
}McpServers
{
"ticktick-mcp-ekkyarmandi": {
"command": "python",
"args": [
"main.py"
]
}
}TickTick MCP
A Model Context Protocol (MCP) server that provides tools for integrating TickTick task management tools. Using Python and the MCP SDK.
Overview
This repository contains a Model Context Protocol (MCP) server implementation for TickTick. It provides a standardized way for AI assistants and applications to interact with TickTick's task management functionality, allowing operations like:
- Retrieving projects and tasks
- Creating new projects and tasks
- Updating task details
- Completing and deleting tasks
With this MCP, AI systems can act as task masters to help manage your to-do lists and tasks in TickTick with natural language.
Requirements
- Python 3.8+
- TickTick account
- TickTick API key (via OAuth) # COMMENT: I will add a tool to generate an API key from the TickTick developer portal
Installation
1. Clone this repository
git clone https://github.com/ekkyarmandi/ticktick-mcp.git
cd ticktick-mcp
2. Install dependencies
pip install -r requirements.txt
Obtaining a TickTick API Key
This MCP uses TickTick's OpenAPI scheme, which requires registering an app through TickTick's developer portal:
1. Go to the TickTick Developer Documentation
2. Click on Manage Apps in the top right corner and login with your TickTick credentials
3. Register a new app by clicking the +App Name button
4. Enter a name for your app (only required field)
5. Once created, you'll be able to see your Client ID and Client Secret
6. For the OAuth Redirect URL, enter a URL where you'll be redirected after authorization (e.g., http://127.0.0.1:8080)
Authorizing Your App
After registering your app, use the ticktick-py library to get your access token:
```python
from ticktick.oauth2 import OAuth2
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
