MCP Ticktick

🚀 TickTick MCP Server

This is a Model Context Protocol (MCP) server created for TickTick, enabling you to directly interact with your TickTick task management system via Claude and other MCP clients.

✨ Features

• 📋 View all TickTick projects and tasks.
• ✏️ Create new projects and tasks using natural language.
• 🔄 Update details of existing tasks (title, content, date, priority).
• ✅ Mark tasks as completed.
• 🗑 Delete tasks.
• 🔧 Create new projects.
• 🗙 Delete projects.

🛠 Prerequisites

Before running this project, make sure you have installed the following software and tools:

• Python 3.8 or higher.
• pip (Python package manager).

📦 Installation

1. Download and extract the project folder.
2. In the project root directory, create a config folder and place your TickTick API key (app_key) and secret (app_secret) inside.
3. Open a terminal or command prompt and navigate to the project root directory.
4. Run the following command to install all dependencies:

pip install -r requirements.txt

5. Start the server:

python ticktick_mcp/ticktick_client.py

🔑 Authentication Process

1. After starting the server, you will be redirected to the TickTick authorization page.
2. Log in to your TickTick account and grant the necessary permissions.
3. Copy the generated authorization code and paste it back to the location prompted by the server.

💻 Usage Examples

Basic Usage

# Display all projects
curl http://localhost:5000/projects

# Create a new task
curl -X POST -H "Content-Type: application/json" -d '{"title":"Complete MCP server documentation","project_id":"your_project_id","priority":"high"}' http://localhost:5000/tasks

# Mark a task as completed
curl -X PUT -H "Content-Type: application/json" -d '{"project_id":"your_project_id", "task_id":"task_id"}' http://localhost:5000/complete_task

# Delete a project
curl -X DELETE -H "Content-Type: application/json" -d '{"project_id":"your_project_id"}' http://localhost:5000/delete_project

📚 Documentation

Project Structure

ticktick-mcp/
├── .env.template          # Environment variable template
├── README.md              # Project documentation
├── requirements.txt       # Project dependencies
├── setup.py               # Package setup file
├── test_server.py         # Test script
└── ticktick_mcp/          # Main program package
    ├── __init__.py        # Package initialization
    ├── authenticate.py    # OAuth authentication tool
    ├── cli.py             # Command-line interface
    └── src/               # Source code
        ├── __init__.py    # Module initialization
        ├── auth.py        # OAuth authentication implementation
        ├── server.py      # MCP server implementation
        └── ticktick_client.py  # TickTick API client

Contribution Guidelines

Contributions are welcome! Please follow these steps to submit a pull request:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Submit a pull request.

📄 License

This project is released under the MIT License. Please refer to the LICENSE file for details.