Todoist MCP 서버

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

특징

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

필수 조건

파이썬 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

예시 상호작용

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

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

보안 고려 사항

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

특허

MIT 라이센스

Todoist Python MCP Server

Integrations