TickTick MCP Server
by jen6
Enhance your TickTick workflow with this MCP server. Built upon the `ticktick-py` library, it offers significantly improved filtering capabilities, allowing AI assistants and MCP-compatible applications to interact with your tasks with greater precision and power.
Last updated: N/A
What is TickTick MCP Server?
This server provides a Model Context Protocol (MCP) interface to the TickTick task management service, enabling AI assistants and other MCP-compatible applications to interact with your tasks.
How to use TickTick MCP Server?
- Register a TickTick application and obtain API credentials. 2. Configure environment variables with your credentials. 3. Run the server either directly via Python or through an MCP client (like Claude Desktop or VS Code Agent Mode). 4. Authorize the application via the OAuth2 flow on the first run.
Key features of TickTick MCP Server
Create, update, delete, complete, and move tasks.
Create subtasks by linking existing tasks.
Retrieve tasks by ID, specific fields, or project.
Filter tasks based on various criteria (priority, project, tags, etc.).
Retrieve all projects, tags, and project folders.
Convert datetime strings to the required TickTick format.
Use cases of TickTick MCP Server
Integrating TickTick with AI assistants for task management.
Automating task creation and updates based on external triggers.
Building custom workflows for managing tasks within MCP-compatible applications.
Filtering and retrieving tasks based on complex criteria for reporting or analysis.
FAQ from TickTick MCP Server
What is MCP?
What is MCP?
Model Context Protocol (MCP) is a standard for enabling communication between different applications and AI models.
What is ticktick-py?
What is ticktick-py?
ticktick-py is an unofficial Python library for interacting with the TickTick API.
How do I get TickTick API credentials?
How do I get TickTick API credentials?
You need to register an application with TickTick through their OpenAPI Documentation and obtain a Client ID and Client Secret.
What is the OAuth Redirect URI?
What is the OAuth Redirect URI?
The OAuth Redirect URI is a URL where TickTick will redirect the user after they authorize the application. It doesn't need to be a live URL, but it must be saved in your environment variables.
Where does the .token-oauth file get stored?
Where does the .token-oauth file get stored?
The .token-oauth file is stored in the same directory as your .env file, which is typically ~/.config/ticktick-mcp/.