TickTick Task 관리 도구를 통합하는 모델 Context Protocol (MCP) 서버. Python 및 MCP SDK를 사용합니다.

개요

이 저장소에는 TickTick에 대한 Model Context Protocol (MCP) 서버 구현이 포함되어 있습니다. 그것은 TickTick의 작업 관리 기능과 상호 작용하는 AI 조수와 신청을 위한 표준화한 방법을 제공합니다, 같이 가동을 허용하:

• 프로젝트 및 작업 검색
• 새로운 프로젝트 및 작업 만들기
• 작업 내용 업데이트
• 작업 완료 및 삭제

이 MCP를 통해 AI 시스템은 TickTick에서 얻은 목록을 관리하고 자연어로 작업하는 데 도움이되는 작업 마스터 역할을 할 수 있습니다.

요구 사항

• 파이썬 3.8+
• TickTick 계정
• TickTick API 키 (OAuth를 통해) # COMMENT : TickTick 개발자 포털에서 API 키를 생성하는 도구를 추가합니다.

설치

1. Clone 이 저장소

2. 의존성 설치

TickTick API 키 획득

이 MCP는 TickTick의 OpenAPI 계획을 사용하여 TickTick의 개발자 포털을 통해 앱을 등록해야합니다.

1. TickTick 개발자 문서로 이동
2. 상단 오른쪽 코너에서 [T0]을 클릭하고 TickTick credentials로 로그인하십시오.
3. 명세.

TickTick MCP

A Model Context Protocol (MCP) server that provides tools for integrating TickTick task management tools. Using Python and the MCP SDK.

Overview

This repository contains a Model Context Protocol (MCP) server implementation for TickTick. It provides a standardized way for AI assistants and applications to interact with TickTick’s task management functionality, allowing operations like:

• Retrieving projects and tasks
• Creating new projects and tasks
• Updating task details
• Completing and deleting tasks

With this MCP, AI systems can act as task masters to help manage your to-do lists and tasks in TickTick with natural language.

Requirements

• Python 3.8+
• TickTick account
• TickTick API key (via OAuth) # COMMENT: I will add a tool to generate an API key from the TickTick developer portal

Installation

1. Clone this repository

   git clone https://github.com/ekkyarmandi/ticktick-mcp.git
   cd ticktick-mcp
   

2. Install dependencies

   pip install -r requirements.txt
   

Obtaining a TickTick API Key

This MCP uses TickTick’s OpenAPI scheme, which requires registering an app through TickTick’s developer portal:

1. Go to the TickTick Developer Documentation
2. Click on Manage Apps in the top right corner and login with your TickTick credentials
3. Register a new app by clicking the +App Name button
4. Enter a name for your app (only required field)
5. Once created, you’ll be able to see your Client ID and Client Secret
6. For the OAuth Redirect URL, enter a URL where you’ll be redirected after authorization (e.g., http://127.0.0.1:8080)

Authorizing Your App

After registering your app, use the ticktick-py library to get your access token:

from ticktick.oauth2 import OAuth2

# Replace with your details from the developer portal
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
redirect_uri = "YOUR_REDIRECT_URI"  # e.g., http://127.0.0.1:8080

auth_client = OAuth2(client_id=client_id,
                    client_secret=client_secret,
                    redirect_uri=redirect_uri)

# This will open a web browser for authorization
# Follow the instructions in the terminal to authorize
auth_client.get_access_token()

After authorizing, the access token will be saved to a .token-oauth file by default. You can extract the token from this file or use:

print(auth_client.token_info["access_token"])

Configuration

1. Create a .env file in the root directory with your TickTick API key:

   TICKTICK_API_KEY=your_access_token_here
   

Usage

Run the MCP server:

python main.py

This will start the MCP server on port 8000. You can now connect to it using any MCP client.

Available Tools

The server provides the following tools:

• get_projects: Get a list of all projects