Todoist MCP(Model Context Protocol) 서버를 Claude Code에 연결하여 터미널에서 직접 작업을 관리하세요. 연결되면 코딩 환경을 벗어나지 않고도 Todoist 작업 및 프로젝트를 생성하고 읽고 업데이트할 수 있어 작업 추적 중에도 흐름을 유지하는 데 좋습니다.
또한 Claude의 Todoist 커넥터를 통해 Todoist를 Claude에 연결하여 채팅 우선 워크플로를 이용할 수 있습니다. 연결되면 Claude가 Todoist 작업 및 프로젝트를 읽고, 생성하고, 업데이트할 수 있습니다. 자세한 지침은 Todoist와 Claude 사용하기를 참조하세요.
요구사항 확인
- 유료 Claude 플랜 (Pro, Max, 팀, Enterprise 또는 Console). 무료 Claude.ai 플랜에는 Claude Code 접근이 포함되지 않습니다.
- Claude Code가 기기에 설치 및 인증되었습니다.
- OAuth로 로그인하게 되며, 이는 Claude Code가 공식 Todoist MCP 서버를 통해 Todoist에 접근하도록 승인하는 것을 의미합니다.
Claude Code에 Todoist MCP 설정하기
1. Todoist MCP 서버 추가
터미널을 열고 다음 명령어를 실행하세요:
claude mcp add --transport http Todoist https://ai.todoist.net/mcp
2. 서버 추가 확인
명령이 완료되면 터미널에 다음 응답이 나타납니다.
1 MCP 서버에 인증 필요 · /mcpTodoist MCP 서버가 추가되었으며, 승인을 기다리고 있습니다.
3. MCP 서버 목록 열기
같은 터미널에서 /mcp를 입력하고 Enter를 누르세요. 그러면 새로 추가된 Todoist 서버를 포함하여 설치된 모든 MCP 서버 목록이 열립니다.
4. Todoist 서버 선택
↑ 및 ↓ 화살표 키를 이용해 목록에서 Todoist로 이동한 다음 Enter 키를 누르세요.
5. 인증 흐름을 완료하십시오.
화면의 지시에 따라 Todoist 계정에 로그인하고 Claude Code에 필요한 승인을 부여하세요.
승인되면 Todoist를 Claude Code에서 이용할 준비가 완료됩니다.
Claude Code가 접근할 수 있는 항목
연결되면 Claude Code는 Todoist MCP 서버를 이용하여 다음을 수행할 수 있습니다:
- Todoist 작업과 프로젝트를 읽습니다
- 작업과 프로젝트를 생성합니다
- 작업 및 프로젝트 (예. 이름 변경, 일정 변경, 프로젝트 이동)를 업데이트합니다
참고
수행할 수 있는 작업 예시
연결 후 잘 작동하는 몇 가지 프롬프트는 다음과 같습니다.
| 카테고리 | 프롬프트 예시 |
|---|---|
| 코드에서 작업 수집 | Todoist에 'login.js의 인증 버그 수정' 작업을 추가하고 엔지니어링 프로젝트에 넣으세요. '결제 모듈 단위 테스트 작성' 작업을 생성하고 이번 주 금요일까지 기한을 설정하세요. |
| 업무 계획 | 기한이 지난 Todoist 작업 목록을 보여주고 오늘 어떤 작업을 처리할지 결정하는 데 도와주세요. 이번 주에 마감인 모든 작업을 보여주고 현실적으로 완료할 수 있는 작업을 제안해 주세요. |
| 관리함 정리 | Todoist 관리함의 각 아이템을 명확하고 실행 가능한 다음 단계로 전환하세요. '대기 중'으로 태그된 모든 작업을 '대기 중' 섹션으로 이동시키고 다음 주 월요일에 후속 작업을 추가하세요. |
| 업무 흐름 유지 | 결제 기능을 작업 중입니다. Todoist를 확인하고 관련 미해결 작업이 있는지 알려주세요. 이 파일의 모든 TODO 댓글에 대해 작업을 추가하고 현재 스프린트 프로젝트에 모두 넣어주세요. |
개인 보호 및 데이터 처리
MCP를 통해 Todoist를 연결할 때, 작업 데이터는 Todoist 서버와 Claude 모두와 공유됩니다. Todoist 측의 데이터 처리는 Todoist의 개인 보호 정책에 따르며, Claude의 컨텍스트에 입력되는 데이터(작업, 프로젝트 등)는 Anthropic의 개인 보호 정책에도 적용됩니다.
안심하고 사용하실 수 있도록, Todoist의 설정 > 통합에서 언제든지 부여한 권한을 검토할 수 있습니다.
Todoist MCP 연결 해제
다음 두 곳에서 연결을 해제할 수 있습니다:
- Claude Code에서: 터미널에서
claude mcp remove todoist를 실행하여 서버를 삭제하세요. - Todoist에서설정 > 통합으로 이동하여 Claude Code의 접근을 취소하세요.
문제 해결
The claude mcp add 명령이 인식되지 않습니다
Claude Code가 설치되어 있고 최신 버전인지 확인하세요. 설치 지침은 Claude Code 문서를 참조하세요.
OAuth 브라우저 창이 열리지 않습니다
Claude Code 명령을 다시 실행해 보세요. 창이 계속 나타나지 않으면 브라우저에서 팝업창이 차단되어 있지 않은지 확인하고 다시 시도하세요.
서버는 Claude MCP 목록에 표시되지만 Todoist 도구는 유효하지 않습니다
서버를 추가한 후 새 Claude Code 세션을 시작하세요. MCP 서버는 세션 시작 시에만 불러오므로, 기존 세션에서는 새 연결을 인식하지 못합니다.
버그를 보고하거나 기능을 요청하세요
Todoist MCP 서버는 오픈 소스입니다. 공식 GitHub의 Todoist AI 저장소에서 버그를 보고하거나, 기능을 요청하거나, 알려진 문제를 검색할 수 있습니다.
연락
Todoist MCP를 Claude Code에 연결하는 과정에서 문의사항이 있다면, 저희에게 연락하세요.