TickTick MCP
About
TickTick MCP for managing your To-Do using AI
Details
- License
- MIT license
Explore
- 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
- 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
get_projects
Get a list of all projects
project_details
Get details of a specific project
get_task_details
Get details of a specific task
create_project
Create a new project
create_task
Create a new task in a project
update_task
Update an existing task
complete_task
Mark a task as complete
delete_task
Delete a task
The server provides the following tools:
- get_projects: Get a list of all projects
- project_details: Get details of a specific project
- get_task_details: Get details of a specific task
- create_project: Create a new project
- create_task: Create a new task in a project
- update_task: Update an existing task
- complete_task: Mark a task as complete
- delete_task: Delete a task
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"
]
}
}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.
