通过这台MCP服务器提升您的TickTick工作流程。基于ticktick-py库，它提供了显著提升的过滤功能，使AI助手和兼容MCP的应用程序（如Claude Desktop、VS Code Agent Mode或mcp-use）能够更精准、更高效地与您的任务交互。

✨ 特色

该服务器通过MCP工具提供对TickTick功能的全面访问，分类如下：

• 任务管理： 创建、更新（包括转换为 TickTick 的日期格式）、删除、完成和移动任务。
• 子任务管理： 通过链接现有任务创建子任务。
• 任务检索：
• 完成所有未完成任务。
• 按ID或特定字段获取任务。
• 在特定日期范围内完成任务。
• 从特定项目中获得任务。
• 根据各种关键（优先级、项目、标签等）筛选任务。
• 项目/标签管理： 检索所有项目、标签和项目文件夹。
• 辅助工具： 将日期时间字符串转换为所需的 TickTick 格式。

请参阅 src/ticktick_mcp/tools/ 目录中的工具定义以获取详细规格。

🚀 开始

TickTick MCP Server

Enhance your TickTick workflow with this MCP server. Built upon the ticktick-py library, it offers significantly improved filtering capabilities, allowing AI assistants and MCP-compatible applications (like Claude Desktop, VS Code Agent Mode, or mcp-use) to interact with your tasks with greater precision and power.

✨ Features

This server provides comprehensive access to TickTick functionalities via MCP tools, categorized as follows:

• Task Management: Create, update (including conversion to TickTick’s date format), delete, complete, and move tasks.
• Subtask Management: Create subtasks by linking existing tasks.
• Task Retrieval:
  • Get all uncompleted tasks.
  • Get tasks by ID or specific fields.
  • Get completed tasks within a date range.
  • Get tasks from a specific project.
  • Filter tasks based on various critggeria (priority, project, tags, etc.).
• Project/Tag Management: Retrieve all projects, tags, and project folders.
• Helper Tools: Convert datetime strings to the required TickTick format.

Refer to the tool definitions within the src/ticktick_mcp/tools/ directory for detailed specifications.

🚀 Getting Started

This server utilizes the unofficial ticktick-py library to interact with the TickTick API.

Prerequisites

• Python >= 3.10
• Access to TickTick and API credentials (see below).

Setup

1. Register a TickTick Application: Before using the server, you need to register an application with TickTick to obtain API credentials. Follow these steps based on the ticktick-py documentation:

   • Go to the TickTick OpenAPI Documentation and log in with your TickTick account.
   • Click on Manage Apps in the top right corner.
   • Register a new app by clicking the +App Name button. Provide a name for your application (e.g., “MCP Server”).
   • Once created, edit the app details. Note down the generated Client ID and Client Secret.
   • For the OAuth Redirect URL, enter a URL where you want to be redirected after authorizing the application. It doesn’t need to be a live URL
     • http://localhost:8080/redirect or http://127.0.0.1:8080/ are common choices for local development.
     • Ensure this exact URL is saved in your environment variables.

2. Environment Variables: The server requires the TickTick API credentials you just obtained, plus your TickTick login details. By default, it looks for a .env file located at ~/.config/ticktick-mcp/.env.