Todoist MCP 서버

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

특징

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

Related MCP server: Notion MCP

필수 조건

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

Todoist API 토큰을 얻는 방법

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

Claude Desktop과 함께 사용

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

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

지엑스피1

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

{ "mcpServers": { "todoist-server": { "command": "uvx", "args": [ "--from", "https://github.com/Johnxjp/todoist-mcp-python.git", "mcp-server-todoist" ], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } }

복제된 저장소에서 실행

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

git clone git@github.com:Johnxjp/todoist-mcp-python.git

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

{ "mcpServers": { "todoist-server": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "--with", "todoist_api_python", "mcp", "run", "/full/path/to/todoist_server.py" ], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } }

사용 가능한 도구

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

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