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

license - not found

quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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

Related MCP Servers

Notion MCP
Badhansen
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
Last updated -
13
Python
MIT License
ConnectWise Manage MCP Server
ethangillani
-
security
A
license
-
quality
A Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
Last updated -
JavaScript
MIT License
Todoist Python MCP Server
Johnxjp
-
security
A
license
-
quality
A Model Context Profile server that enables Claude to interact with Todoist, allowing users to create, retrieve, update, and manage tasks through natural language commands.
Last updated -
1
Python
MIT License
Google Tasks MCP Server
arpitbatra123
-
security
A
license
-
quality
A Model Context Protocol server that bridges Claude with Google Tasks, allowing users to manage task lists and tasks directly through Claude interface.
Last updated -
5
TypeScript
MIT License

View all related MCP servers

Appeared in Searches

A tool or application for creating a to-do list

MCP Todoist