Todoist Python MCP Server

Todoist MCP 서버

Claude와 같은 클라이언트가 Todoist와 상호 작용하여 자연어를 통한 작업 관리 기능을 활성화할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 클라이언트와 Todoist API 사이의 중개자 역할을 하며 인증, 데이터 변환 및 명령 처리를 담당합니다. 이는 Python 버전입니다.

특징

• 작업 생성 : 필수 콘텐츠와 선택적 속성을 사용하여 새 작업을 생성합니다.
• 작업 검색 : ID로 작업 가져오기 또는 필터링 옵션을 사용하여 작업 나열
• 작업 관리 : 작업 속성 업데이트, 작업 완료로 표시, 작업 삭제

필수 조건

• 파이썬 3.12
• 자외선
• Todoist 계정 및 API 토큰

Todoist API 토큰을 얻는 방법

1. Todoist 계정에 로그인하세요
2. 사용자 설정 -> 통합 -> 개발자로 이동하세요.
3. API 토큰 복사

Claude Desktop과 함께 사용

UVX를 통해 실행(복제 없음)

UVX를 사용하여 GitHub에서 직접 서버를 실행할 수 있습니다.

지엑스피1

그런 다음 Claude 설정에 다음 구성을 추가합니다.

복제된 저장소에서 실행

저장소를 복제하려면 다음 명령을 사용하세요.

그런 다음 Claude 구성 파일에 다음을 추가합니다.

사용 가능한 도구

서버는 Claude가 사용할 수 있는 다음과 같은 도구를 제공합니다.

1. create_task : Todoist에서 새 작업 만들기
   • 필수: 콘텐츠(작업 제목)
   • 선택 과목:
     • 설명,
     • 마감일,
     • 우선 사항,
     • 프로젝트_아이디,
     • 섹션_아이디,
     • 라벨
2. get_tasks : 다양한 필터를 사용하여 Todoist에서 작업 및 ID 목록을 가져옵니다.
   • 선택 과목:
     • 프로젝트_아이디,
     • 프로젝트 이름,
     • 작업 이름,
     • 우선 사항,
     • 라벨,
     • 연체되었습니다,
     • 한계
3. update_task : 이름으로 검색하여 기존 작업을 업데이트합니다.
   • 필수: task_id
   • 선택 과목:
     • 콘텐츠,
     • 설명,
     • 라벨,
     • 우선 사항,
     • 마감일(YYYY-MM-DD),
     • 마감일(YYYY-MM-DD)
4. delete_task : 이름으로 검색하여 작업을 삭제합니다.
   • 필수: task_id
5. complete_task : 이름으로 검색하여 작업을 완료로 표시합니다.
   • 필수: task_id

예시 상호작용

다음은 Claude가 MCP 서버를 통해 Todoist와 상호 작용하는 방법에 대한 몇 가지 예입니다.

• "식료품 구매 작업 추가"
• "내 모든 긴급한 작업을 보여주세요"
• "오늘 마감일은 뭐예요?"
• "세탁 작업을 완료로 표시"
• "치과 예약 우선순위를 긴급으로 변경해 주세요"

보안 고려 사항

• 서버는 환경 변수를 통해 Todoist API 토큰을 안전하게 처리합니다.
• .env 파일을 공유하거나 API 토큰을 노출하지 마십시오.
• 서버는 로컬로 실행되며 Todoist API와만 통신합니다.

특허

MIT 라이센스

감사의 말

• Todoist API 파이썬 클라이언트
• 모델 컨텍스트 프로토콜