Улучшите рабочий процесс TickTick с помощью этого MCP-сервера. Построенный на библиотеке T0, он предлагает значительно улучшенные возможности фильтрации, позволяя помощникам ИИ и MCP-совместимым приложениям (таким как Claude Desktop, VS Code Agent Mode или T1) взаимодействовать с вашими задачами с большей точностью и мощностью.

Feature Особенности

Этот сервер обеспечивает полный доступ к функциям TickTick с помощью инструментов MCP, классифицированных следующим образом:

Управление задачами: Создавать, обновлять (включая преобразование в формат даты 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.