Todoist MCP 서버

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

특징

• 작업 생성 : 필수 콘텐츠와 선택적 속성을 사용하여 새 작업을 생성합니다.

• 작업 검색 : ID로 작업 가져오기 또는 필터링 옵션을 사용하여 작업 나열

• 작업 관리 : 작업 속성 업데이트, 작업 완료로 표시, 작업 삭제

Related MCP server: Todoist MCP Server

필수 조건

• 파이썬 3.12

• 자외선

• Todoist 계정 및 API 토큰

Todoist API 토큰을 얻는 방법

1. Todoist 계정에 로그인하세요

2. 사용자 설정 -> 통합 -> 개발자로 이동하세요.

3. 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가 사용할 수 있는 다음과 같은 도구를 제공합니다.

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 파이썬 클라이언트

• 모델 컨텍스트 프로토콜