ticktick-sdk: A TickTick MCP Server & Full Python SDK
A comprehensive async Python SDK for TickTick with MCP (Model Context Protocol) server support.
Includes full support for Dida365 (滴答清单) as well.
Use TickTick programmatically from Python, or let AI assistants manage your tasks.
Table of Contents
- Features
- Why This Library?
- Installation
- MCP Server Setup & Usage
- Step 1: Register Your App
- Step 2: Get OAuth2 Access Token
- Step 3: Configure Your AI Assistant
- CLI Reference
- Example Conversations
- Available MCP Tools
- Python Library Setup & Usage
- Setup
- Quick Start
- Tasks
- Projects & Folders
- Tags
- Habits
- Focus/Pomodoro
- User & Statistics
- Error Handling
- Architecture
- API Reference
- TickTick API Quirks
- Environment Variables
- Running Tests
- Troubleshooting
- Contributing
Features
MCP Server
- 43 Tools: Streamlined coverage of TickTick functionality
- Batch Operations: All mutations accept lists (1-100 items) for bulk operations
- AI-Ready: Works with Claude, GPT, and other MCP-compatible assistants
- Dual Output: Markdown for humans, JSON for machines
