ticktick-mcp

13
calendar_management

The TickTick MCP Server is designed to enhance integration with the TickTick task management service using the Model Context Protocol. It provides advanced task filtering and management features, enabling efficient interactions through MCP-compatible applications.

TickTick MCP Server

Enhance your TickTick workflow with the TickTick MCP Server, which utilizes the ticktick-py library. This server enables MCP-compatible applications to interact with your tasks, offering improved filtering capabilities.

✨ Features

  • Task Management: Create, update, delete, complete, and move tasks.
  • Subtask Management: Link existing tasks to create subtasks.
  • Task Retrieval: Retrieve tasks by various criteria, including project or date range.
  • Project/Tag Management: Access projects, tags, and project folders.
  • Helper Tools: Date formatting for TickTick compatibility.

🚀 Getting Started

This server interacts with the TickTick API via the ticktick-py library.

Prerequisites

  • Python >= 3.10
  • Access to TickTick and API credentials.

Setup

  1. Register a TickTick application to get API credentials.
  2. Configure environment variables for API access.
  3. Conduct OAuth2 authentication on the first run.

🔧 Tools

A variety of tools for task management, retrieval, and datetime conversion are provided.

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request.

📜 License

MIT License.