Todoist

Todoist MCP 서버는 Todoist 작업 관리 서비스와 상호작용하기 위한 MCP(Model Context Protocol) 서버로, 인공지능 어시스턴트가 자연어를 통해 Todoist 작업을 생성, 조회, 수정 및 삭제할 수 있게 해줍니다.

특징

• 자연어 작업 관리: 일상 언어를 사용한 작업 생성, 수정, 완료 및 삭제
• 스마트 작업 검색: 부분 이름 일치를 사용한 작업 검색
• 유연한 필터링: 마감일, 우선순위 및 기타 속성으로 작업 필터링
• 풍부한 작업 세부 정보: 설명, 마감일 및 우선순위 수준 지원
• 직관적인 오류 처리: 더 나은 사용자 경험을 위한 명확한 피드백

API

도구

todoist_create_task

다양한 속성을 가진 새 작업을 생성합니다. - 입력: - content: (필수) 작업 제목 - description: (선택 사항) 작업 설명 - due_date: (선택 사항) 마감일 - priority: (선택 사항) 우선순위 수준 (1-4) - 출력: 생성된 작업의 세부 정보

todoist_get_tasks

작업을 검색하고 필터링합니다. - 입력: - filter: (선택 사항) 마감일, 우선순위 또는 프로젝트별 필터 - limit: (선택 사항) 결과 제한 - 출력: 필터링된 작업 목록

todoist_update_task

자연어 검색을 사용하여 기존 작업을 업데이트합니다. - 입력: - task_name: 검색할 작업 이름 (부분 일치) - content: (선택 사항) 새 작업 제목 - description: (선택 사항) 새 작업 설명 - due_date: (선택 사항) 새 마감일 - priority: (선택 사항) 새 우선순위 수준 (1-4) - 출력: 업데이트된 작업의 세부 정보

todoist_complete_task

자연어 검색을 사용하여 작업을 완료로 표시합니다. - 입력: - task_name: 검색할 작업 이름 (부분 일치) - 출력: 완료 상태 확인

todoist_delete_task

자연어 검색을 사용하여 작업을 삭제합니다. - 입력: - task_name: 검색할 작업 이름 (부분 일치) - 출력: 삭제 확인 메시지

사용 방법

Todoist API 토큰 획득

1. Todoist 계정에 로그인
2. 설정 → 통합으로 이동
3. "개발자" 섹션에서 API 토큰 찾기

설치

npm을 통해 설치:

npm install -g @abhiz123/todoist-mcp-server

또는 Smithery를 통해 Claude Desktop에 자동 설치:

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

Claude Desktop 구성

Claude Desktop 구성 파일에 서버를 추가하는 예시:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "-y",
        "@abhiz123/todoist-mcp-server"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

사용 예시

작업 생성

• "Create task 'Team Meeting'"
• "Add task 'Review PR' due tomorrow at 2pm"
• "Create high priority task 'Fix bug' with description 'Critical performance issue'"

작업 조회

• "Show all my tasks"
• "List tasks due today"
• "Get high priority tasks"
• "Show tasks due this week"

작업 업데이트

• "Update documentation task to be due next week"
• "Change priority of bug fix task to urgent"
• "Add description to team meeting task"

작업 완료

• "Mark the PR review task as complete"
• "Complete the documentation task"

작업 삭제

• "Delete the PR review task"
• "Remove meeting prep task"

보안 고려 사항

• Todoist API 토큰은 계정에 대한 전체 접근 권한을 제공합니다. 토큰을 안전하게 보관하세요.
• 공유 또는 공개 시스템에서 이 서버를 사용할 때는 주의하세요.
• API 토큰이 노출된 경우 Todoist 설정에서 즉시 재생성하세요.

연결된 구성 요소

• Linear
• ClickUp
• Google Tasks
• Google Calendar