Integrations

Enables managing Todoist tasks, projects, and labels. Provides tools for creating, updating, completing, and deleting tasks; organizing tasks in projects and with labels; and searching and filtering tasks based on various criteria.

MCP 투두이스트

클로드가 귀하의 Todoist 계정과 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

특징

작업 관리: 작업 생성, 업데이트, 완료 및 삭제
프로젝트 및 라벨로 작업 구성
다양한 기준에 따라 작업 검색 및 필터링
Claude Desktop과의 원활한 통합

필수 조건

파이썬 3.11+
아스트랄 UV
Todoist 계정 및 API 토큰
Claude Desktop(MCP 서버 사용용)

빠른 시작

1. 설치

지엑스피1

2. 구성

Todoist 통합 설정 에서 Todoist API 토큰을 받으세요
환경 변수를 구성합니다.
# Add to your .env file or environment TODOIST_API_TOKEN=your_api_token_here
Claude Desktop 구성:
// ~/.config/claude/claude_desktop_config.json or equivalent { "mcpServers": { "mcp-todoist": { "command": "uvx", "args": ["mcp-todoist"] } } }

3. Claude와 함께 사용

설정이 완료되면 Claude에게 Todoist 계정과 상호 작용하도록 요청할 수 있습니다.

"오늘 마감인 작업을 보여주세요"
"내일 식료품을 사기 위한 새로운 작업을 만들어주세요"
"내 '이메일 보내기' 작업을 완료로 표시"
"'홈 리노베이션'이라는 새 프로젝트를 만들어 보세요."
"내 작업 프로젝트의 모든 작업을 보여주세요"

사용 가능한 도구

작업 관리

list-tasks - 작업 검색 및 필터링
create-task - 새 작업 만들기
update-task - 기존 작업 업데이트
complete-task - 작업을 완료로 표시
delete-task - 작업 삭제

프로젝트 관리

list-projects - 모든 프로젝트 가져오기
create-project - 새 프로젝트 만들기
update-project - 프로젝트 업데이트
delete-project - 프로젝트 삭제

라벨 관리

list-labels - 모든 라벨 가져오기
create-label - 새 라벨 만들기
update-label - 레이블 업데이트
delete-label - 레이블 삭제

유용

search - 복잡한 필터링을 통해 작업 검색

MCP 서버 실행

Todoist MCP 서버를 실행하는 방법은 여러 가지가 있습니다.

방법 1: 직접 명령줄

터미널 창에서 서버를 실행합니다.

# Set your API token
export TODOIST_API_TOKEN=your_api_token_here

# Run the server using UV
uvx mcp-todoist

# Alternative: Run from source
cd /path/to/mcp-todoist
uv run python -m mcp_todoist

Claude Desktop을 사용하는 동안 이 터미널 창을 열어 두세요.

방법 2: 시작 스크립트 사용(권장)

Claude Desktop이 서버를 자동으로 시작하는 데 사용할 수 있는 시작 스크립트를 만듭니다.

다음 내용으로 start-todoist-mcp.sh 라는 이름의 파일을 만듭니다.

#!/bin/bash

# Set environment variables
export MCP_SERVER_NAME="mcp-todoist"
export MCP_LOG_LEVEL="INFO"
export MCP_DEBUG="true"
export TODOIST_API_TOKEN="your_todoist_api_token_here"

# Path to your Todoist MCP server
MCP_PATH="/path/to/mcp-todoist"

# Log file for debugging
LOG_FILE="${MCP_PATH}/todoist-mcp.log"

# Create log file or clear existing one
echo "Starting Todoist MCP server at $(date)" > "${LOG_FILE}"

# Navigate to the project directory
cd "${MCP_PATH}"

# Start the MCP server
echo "Starting MCP server from ${MCP_PATH}" >> "${LOG_FILE}"
uv run python -m mcp_todoist >> "${LOG_FILE}" 2>&1

스크립트를 실행 가능하게 만드세요:

chmod +x start-todoist-mcp.sh

이 스크립트를 사용하려면 Claude Desktop 구성을 업데이트하세요.

{
  "mcpServers": {
    "mcp-todoist": {
      "command": "/absolute/path/to/start-todoist-mcp.sh",
      "args": []
    }
  }
}

이 접근 방식은 다음과 같은 여러 가지 장점을 제공합니다.

서버는 Claude Desktop으로 자동으로 시작됩니다.
모든 로그는 디버깅을 더 쉽게 하기 위해 파일에 캡처됩니다.
환경 변수는 일관되게 설정됩니다.

디버깅

MCP 서버에서 문제가 발생하는 경우 다음과 같은 디버깅 전략을 활용하세요.

1. 로그 확인

시작 스크립트를 사용하는 경우 로그 파일을 확인하세요.

cat /path/to/mcp-todoist/todoist-mcp.log

2. 디버그 모드 활성화

더 자세한 로깅을 위해 MCP_DEBUG 환경 변수를 true 로 설정하세요.

export MCP_DEBUG=true
uvx mcp-todoist

3. API 토큰 확인

Todoist API 토큰이 올바르고 여전히 유효한지 확인하세요.

# Test the token with a simple curl request
curl -X GET \
  https://api.todoist.com/rest/v2/projects \
  -H "Authorization: Bearer $TODOIST_API_TOKEN"

4. MCP 검사기를 사용하세요

MCP Inspector는 MCP 서버를 디버깅하는 강력한 도구입니다.

npx @modelcontextprotocol/inspector uvx mcp-todoist

이렇게 하면 Claude와 MCP 서버 간의 모든 통신을 보여주는 웹 인터페이스가 열립니다.

5. 일반적인 문제 및 해결책

"MCP 서버를 사용할 수 없습니다" 오류 : 서버가 별도의 터미널이나 시작 스크립트를 통해 실행 중인지 확인하세요.
인증 오류 : Todoist API 토큰이 환경에 올바르게 설정되어 있는지 확인하세요.
"명령을 찾을 수 없습니다" 오류 : Astral UV가 설치되어 있고 PATH에 있는지 확인하세요.
시간 초과 오류 : MCP 서버의 응답이 느린 경우 Claude Desktop 설정에서 시간 초과를 늘려보세요.

개발

설정

# Clone the repository
git clone https://github.com/yourusername/mcp-todoist.git
cd mcp-todoist

# Install dependencies
uv sync

테스트

# Run tests
uv run pytest

지역 개발

로컬 개발을 위해 Todoist API 토큰으로 .env 파일을 만들 수 있습니다.

TODOIST_API_TOKEN=your_api_token_here

그런 다음 서버를 실행합니다.

uv run python -m mcp_todoist

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

클로드가 귀하의 Todoist 계정과 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버로, 자연어를 통해 작업, 프로젝트 및 라벨을 관리할 수 있습니다.

Appeared in Searches

A tool or application for creating a to-do list