Ticktick Mcp
@dev-mirzabicer
About Ticktick Mcp
A fully-featured MCP server for TickTick
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"ticktick": {
"command": "ticktick-sdk",
"env": {
"TICKTICK_CLIENT_ID": "your_client_id",
"TICKTICK_CLIENT_SECRET": "your_client_secret",
"TICKTICK_ACCESS_TOKEN": "your_access_token",
"TICKTICK_USERNAME": "your_email",
"TICKTICK_PASSWORD": "your_password"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Ticktick Mcp?
Ticktick Mcp is an MCP (Model Context Protocol) server built on the ticktick-sdk Python library that enables AI assistants like Claude and GPT to manage TickTick tasks programmatically. It provides 45 tools covering task management, project organization, habits, focus/pomodoro, tags, and more, routing operations automatically between TickTick's official V1 API and the undocumented V2 API.
How to use Ticktick Mcp?
Install via pip install ticktick-sdk with Python 3.11+. Configure authentication by registering an OAuth2 app on the TickTick Developer Portal and creating a .env file with your client ID, secret, redirect URI, access token, username, and password. Run python scripts/get_oauth_token.py for the token, then verify with python -c .... The MCP server can then be invoked through any MCP-compatible host; the library itself exposes 45 tools for AI assistants.
Key features of Ticktick Mcp
- 45 MCP tools covering all TickTick features
- Dual output: Markdown for humans, JSON for machines
- Async-first with full Pydantic v2 validation
- Unified routing to V1 (OAuth2) and V2 (session) APIs
- Full habit CRUD with check-ins, streaks, and goals
- Focus/pomodoro session data and statistics
- 300+ tests with comprehensive type hints
Use cases of Ticktick Mcp
- Let an AI assistant create, update, complete, and move tasks in TickTick.
- Query tasks by tag, priority, due date, or search term via natural language.
- Manage projects, folders, and kanban boards programmatically.
- Track habits with check-ins and streak analytics through AI.
- Access productivity stats and focus session data.
FAQ from Ticktick Mcp
What are the runtime requirements for Ticktick Mcp?
Python 3.11+ and a TickTick account (free or Pro). For full functionality, both OAuth2 app registration and account credentials are required.
How does Ticktick Mcp handle TickTick’s two APIs?
It combines the official V1 OAuth2 API and the undocumented V2 session API, automatically routing each operation to the appropriate API based on the feature needed.
Where do my credentials and data live?
All credentials are stored locally in a .env file. Data is accessed via TickTick’s APIs; the server does not store data externally.
What transport does Ticktick Mcp use?
The README does not specify the transport protocol beyond MCP compatibility; it is designed to work with MCP-compatible AI assistants.
How is Ticktick Mcp different from other TickTick libraries?
It is the only library that includes an MCP server, provides async support with Pydantic v2, full habit CRUD, focus/pomodoro access, and automatic V1/V2 routing.
More Developer Tools MCP servers
test
harlancA simple,high performance and secure live media server in pure Rust (RTMP[cluster]/RTSP/WebRTC[whip/whep]/HTTP-FLV/HLS).🦀
MCP-Bridge
SecretiveShellA middleware to provide an openAI compatible endpoint that can call MCP tools
Smithery CLI
smithery-aiInstall, manage and develop MCP servers and skills for agents
sentry-mcp
getsentryAn MCP server for interacting with Sentry via LLMs.
DevDocs by CyberAGI 🚀
cyberagiincCompletely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App
Comments