Claude 및 기타 MCP 클라이언트를 통해 TickTick 작업 관리 시스템과 직접 상호작용할 수 있게 해주는 TickTick용 모델 컨텍스트 프로토콜(MCP) 서버입니다.

특징

• 📋 모든 TickTick 프로젝트 및 작업 보기
• ✏️ 자연어를 통해 새로운 프로젝트와 과제를 생성
• 🔄 기존 작업 세부 사항(제목, 내용, 날짜, 우선순위) 업데이트
• ✅ 작업 완료 표시
• 🗑️ 작업 및 프로젝트 삭제
• 🔄 TickTick의 오픈 API와의 완전 통합
• 🔌 Claude 및 기타 MCP 클라이언트와의 원활한 통합

선수 조건

• Python 3.10 이상
• uv - 빠른 파이썬 패키지 설치 및 해석기
• API 접근 권한이 있는 TickTick 계정
• TickTick API 자격 증명 (클라이언트 ID, 클라이언트 비밀, 접근 토큰)

설치

1. 이 저장소를 복제:

2. uv로 설치하기:

3. TickTick으로 인증하세요:

이 방법은 다음과 같습니다:

• TickTick 클라이언트 ID와 클라이언트 비밀을 요청하기
• TickTick에 로그인할 수 있도록 브라우저 창을 엽니다
• 접근 토큰을 .env 파일에 자동으로 저장합니다

4. 설정 테스트:

이 인증은 TickTick 자격 증명이 올바르게 작동하는지 확인할 수 있습니다.

TickTick과의 인증

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.

Authentication with TickTick

This server uses OAuth2 to authenticate with TickTick. The setup process is straightforward:

1. Register your application at the TickTick Developer Center

   • Set the redirect URI to http://localhost:8000/callback
   • Note your Client ID and Client Secret

2. Run the authentication command:

   uv run -m ticktick_mcp.cli auth
   

3. Follow the prompts to enter your Client ID and Client Secret

4. A browser window will open for you to authorize the application with your TickTick account

5. After authorizing, you’ll be redirected back to the application, and your access tokens will be automatically saved to the .env file

The server handles token refresh automatically, so you won’t need to reauthenticate unless you revoke access or delete your .env file.

Authentication with Dida365

滴答清单 - Dida365 is China version of TickTick, and the authentication process is similar to TickTick. Follow these steps to set up Dida365 authentication:

1. Register your application at the Dida365 Developer Center