ekkyarmandi/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
2. Install dependencies
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:
After authorizing, the access token will be saved to a .token-oauth file by default. You can extract the token from this file or use:
Configuration
1. Create a .env file in the root directory with your TickTick API key:
Usage
Run the MCP server:
This will start the MCP server on port 8000. You can now connect to it using any MCP client.
Available Tools
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
Example Interactions
Once your MCP server is running, AI systems can help manage your tasks with natural language commands like: