TickTick MCP
@ekkyarmandi
About TickTick MCP
TickTick MCP for managing your To-Do using AI
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"ticktick-mcp-ekkyarmandi": {
"command": "python",
"args": [
"main.py"
]
}
}
}Tools
8Get 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().
Frequently asked questions
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()`.
Basic information
More Other MCP servers
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Figs, Relationship Expert
Figs O'Sullivan, LMFTCouples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep
Blender
ahujasidOpen-source MCP to use Blender with any LLM
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Comments