Todoist MCP 서버 확장

Claude(혹은 MCP 호환 LLM)를 Todoist와 통합하는 MCP(모델 컨텍스트 프로토콜) 서버 구현으로, MCP 도구를 통한 자연어 작업 관리가 가능합니다. 이 서버의 도구를 통해 Claude는 일상적인 언어로 Todoist 작업, 프로젝트, 섹션 및 라벨과 상호 작용할 수 있으며, LLM 워크플로 효율성에도 최적화되어 있습니다.

기능 개요

• 작업 관리 : 일상 언어를 사용하여 작업을 생성, 업데이트, 완료 및 삭제합니다.
• 라벨 관리 : 개인 라벨 및 작업 라벨을 생성, 업데이트 및 관리합니다.
• 프로젝트 관리 : Todoist 프로젝트를 만들고, 업데이트하고, 관리하세요
• 섹션 구성 : 프로젝트 내 섹션을 만들고 관리합니다.
• 스마트 검색 : 부분 이름 일치를 사용하여 작업 및 레이블 찾기
• 유연한 필터링 : 프로젝트, 섹션, 마감일, 우선 순위 및 레이블별로 작업 필터링
• 풍부한 작업 세부 정보 : 설명, 마감일, 우선 순위 수준 및 프로젝트/섹션 할당 지원
• 배치 작업 : 도구에는 LLM 워크플로우를 효율적으로 사용할 수 있도록 배치 작업 지원 및 사용자 정의 매개변수가 내장되어 있습니다.

사용 가능한 도구의 전체 목록과 사용법은 tools.md에서 확인하세요.

빠른 설치 가이드

npm이 이미 설치되어 있다고 가정합니다.

더욱 포괄적인 설치 가이드는 사용 방법 가이드에서 확인할 수 있습니다.

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Todoist MCP Server Extended를 설치하는 방법:

1. cmd\pwsh에서 다음 명령을 실행합니다.

지엑스피1

마지막 매개변수를 --client cline 또는 --client windsurf 로 변경하여 cline 또는 windsurf와도 호환 가능

npm을 통해 설치

1. cmd\pwsh에서 다음 명령을 실행합니다.

설정

Todoist API 토큰을 받으세요

1. Todoist 계정 에 로그인하세요
2. Settings → Integrations 으로 이동하세요
3. Developer 에서 API 토큰을 찾으세요
4. Copy API Token 누르세요

Todoist API에 대한 자세한 내용은 공식 Todoist API 문서를 참조하세요.

MCP 서버 및 API 토큰 Claude Desktop Client 추가

1. claude_desktop_config.json 파일에서 다음 json 스니펫을 "mcpServers":{ }:
   "todoist": { "command": "npx", "args": ["-y", "@chrusic/todoist-mcp-server-extended"], "env": { "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE" } }
2. 모두 합치면 다음과 같아야 합니다.
   { "mcpServers": { "todoist": { "command": "npx", "args": ["-y", "@chrusic/todoist-mcp-server-extended"], "env": { "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE" } } } }
3. 그러면 Claude Desktop 클라이언트가 MCP 서버를 시작하고 다음 클라이언트가 (다시) 시작될 때 도구를 로드합니다.

사용 예

클로드에게 물어봐야 할 몇 가지 간단한 제안입니다. 클로드에게 도구를 사용하도록 하려면 때로는 매우 직접적으로 말해야 한다는 점에 유의하세요.

• "MCP 도구 todoist_get_tasks를 사용하여 오늘의 모든 작업을 나열합니다."
• "프로젝트 '작업' 섹션 '할 일'에 'PR 검토' 작업을 만듭니다."
• "작업 'PR 검토'에 '중요' 라벨 추가"
• "프로젝트 '작업'에서 '중요' 라벨이 있는 모든 작업 표시"
• "작업 '문서'를 '진행 중' 섹션으로 이동"
• "문서화 작업을 완료로 표시"
• "오늘 시내로 쇼핑하러 가는 길에 할 수 있는 나열된 작업에 대한 몇 가지 제안을 해주세요."
• "X 작업을 더 작은 하위 작업으로 나누고 마감일을 x, y, z로 추가합니다."

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

문제 및 지원

문제가 발생하거나 지원이 필요한 경우 GitHub 저장소 에 문제를 제출하세요.