Happy slice of mcp pizzaMCP.pizza

ticktick-mcp

MCP.Pizza Chef: jacepark12

TickTick keeps your lists and due dates, and this hands them to your assistant so you can ask what is due today, what has slipped, or what matters most, then add, reschedule, tick off or delete tasks and whole projects without opening the app. Dida365, the Chinese edition, works too. Getting started means registering for developer access with TickTick and signing in once. The code has not changed since July 2025 and names no successor.

Unmaintained · nothing changed since July 2025, no replacement named
Calendar
Notes

Use This MCP server To

See everything due today across all my lists Add a task with a due date and priority Round up every overdue task in one go Mark several tasks complete without opening the app Create a whole project's worth of tasks at once Ask what I should pick up next

README

TickTick MCP Server

A Model Context Protocol (MCP) server for TickTick that enables interacting with your TickTick task management system directly through Claude and other MCP clients.

Features

  • 📋 View all your TickTick projects and tasks
  • ✏️ Create new projects and tasks through natural language
  • 🔄 Update existing task details (title, content, dates, priority)
  • ✅ Mark tasks as complete
  • 🗑️ Delete tasks and projects
  • 🔄 Full integration with TickTick's open API
  • 🔌 Seamless integration with Claude and other MCP clients

Prerequisites

  • Python 3.10 or higher
  • uv - Fast Python package installer and resolver
  • TickTick account with API access
  • TickTick API credentials (Client ID, Client Secret, Access Token)

Installation

  1. Clone this repository:

    git clone https://github.com/jacepark12/ticktick-mcp.git
cd ticktick-mcp

  2. Install with uv:

    # Install uv if you don't have it already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a virtual environment
uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

# Install the package
uv pip install -e .

  3. Authenticate with TickTick:

    # Run the authentication flow
uv run -m ticktick_mcp.cli auth

    This will:

    • Ask for your TickTick Client ID and Client Secret
    • Open a browser window for you to log in to TickTick
    • Automatically save your access tokens to a .env file

  4. Test your configuration:

    uv run test_server.py

    This will verify that your TickTick credentials are working correctly.

ticktick-mcp FAQ

Is this still maintained?
It appears dormant. The repository is not archived, but nothing has changed since July 2025 and no replacement project is named.
Which apps does it work in?
Claude Desktop is what the instructions cover, and other apps that speak the same protocol can connect as well.
Do I need a key?
Yes. You register for developer access on TickTick's site, then sign in once so your access is saved and refreshed automatically.
Can I use this to plan my day?
Yes. You can ask what is due today, what is overdue and what is high priority, then move dates around by asking.
Does it work with Dida365?
Yes. Dida365, the Chinese edition of TickTick, is supported by pointing the setup at its own sign-in addresses.
Can it delete my tasks?
Yes, it can remove individual tasks and entire projects, so be specific about what you want gone.
How hard is the setup?
It is the most involved kind: you download the code, install it with a Python tool, and complete a one-time sign-in from a terminal.