ticktick-mcp

ticktick-mcp

53

The TickTick MCP Server is designed to integrate TickTick's task management capabilities directly with Claude and other MCP clients, allowing for an extensive range of task management activities such as viewing, creating, and updating tasks and projects. Featuring seamless API integration, this server makes task management more efficient through natural language commands.

TickTick MCP Server

A Model Context Protocol (MCP) server for integrating TickTick task management with Claude and other MCP clients.

Features

  • View, create, update, complete, and delete TickTick projects and tasks
  • Full integration with TickTick's open API
  • Seamless connectivity with Claude

Prerequisites

  • Python 3.10 or higher
  • Fast Python package installer and resolver (uv)
  • TickTick account with API access

Installation

  1. Clone the repository and navigate to the directory
  2. Install with uv and create a virtual environment
  3. Authenticate with TickTick using OAuth2

Authentication

  1. Register at TickTick Developer Center
  2. Run the authentication command and follow the prompts

Usage with Claude for Desktop

  1. Install Claude for Desktop
  2. Edit the configuration file to connect the TickTick MCP server
  3. Restart Claude for Desktop

Available MCP Tools

  • List and manage projects and tasks

Development

The project implements a complete OAuth 2.0 flow and provides a structured directory for easy contribution.