TickTick

About

This library offers a comprehensive, async-first Python SDK for TickTick, designed to provide full programmatic control over tasks, projects, habits, and more. It uniquely solves TickTick's 'two-API problem' by intelligently routing operations to either the official V1 OAuth2 API or the reverse-engineered V2 session API, ensuring access to a wider range of features like tags, habits, and subtasks. Beyond its robust Python library, it integrates an MCP (Model Context Protocol) server, enabling AI assistants like Claude and GPT to seamlessly manage tasks, offering both human-readable Markdown and machine-consumable JSON outputs.

Key Features

• Full Async Python SDK for comprehensive TickTick management
• Unified V1+V2 API Routing for complete feature access (tasks, habits, tags, subtasks)
• MCP Server Integration, enabling AI assistants to manage TickTick tasks
• Full Habit Tracking with CRUD operations, check-ins, streaks, and goals
• Type-Safe with Pydantic v2 validation and comprehensive type hints
• 1 GitHub stars

Use Cases

• Automate TickTick task management and habit tracking programmatically with Python scripts
• Integrate AI assistants to manage personal or team tasks through the MCP server
• Develop custom productivity tools or analytics dashboards utilizing TickTick data