이 MCP 서버로 TickTick 워크플로우를 향상시킵니다. ticktick-py] 라이브러리에 내장되어, 그것은 크게 향상된 필터링 기능을 제공합니다, AI 조수와 MCP 호환 응용 프로그램을 허용 (클래드 데스크톱, VS 코드 에이전트 모드와 같은, 또는 mcp-use) 더 큰 정밀도와 힘으로 작업과 상호 작용.

✨ 특징

이 서버는 MCP 도구를 통해 TickTick 기능에 대한 포괄적 인 액세스를 제공합니다, 다음과 같이 분류 :

• Task Management: 생성, 업데이트 (TickTick의 날짜 형식으로 변환 포함), 삭제, 완료 및 작업 이동.
• Subtask 관리: 기존 작업을 연결하여 subtasks를 만듭니다.
• Task Retrieval:
• 모든 불완전한 작업을 가져옵니다.
• ID 또는 특정 필드로 작업을 가져옵니다.
• 날짜 범위 내에서 완료된 작업을 가져옵니다.
• 특정 프로젝트에서 작업을 가져옵니다.
• 각종 critggeria (priority, 프로젝트, 꼬리표, 등)에 근거를 둔 필터 작업. *Project/Tag 관리: 모든 프로젝트, 태그 및 프로젝트 폴더를 검색합니다. *Helper 도구: TickTick 형식에 datetime 문자열을 변환합니다.

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.