자연어를 통해 Claude와 Todoist를 연결하여 완전한 작업 및 프로젝트 관리를 수행하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

설치

클로드 데스크톱 (원클릭 설치)

1. 최신 릴리스에서 todoist-mcp.mcpb 다운로드
2. 파일을 더블 클릭(또는 Claude Desktop으로 드래그)
3. 요청 시 Todoist API 토큰을 입력
4. 채팅 시작: “내 Todoist 프로젝트를 보여줘”

클로드 코드 / 기타 MCP 클라이언트

수동 JSON 구성

MCP 클라이언트 설정에 추가하세요 (claude_desktop_config.json, ~/.claude.json 등):

설정 위치:

• 클로드 데스크톱 (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• 클로드 데스크톱 (Windows): %APPDATA%\Claude\claude_desktop_config.json
• 클로드 코드: ~/.claude.json

특징

• 19 완전한 토도이스트 관리를 위한 MCP 도구
• 작업 관리: 우선순위, 마감일, 라벨이 있는 작업 생성, 업데이트, 삭제, 완료, 재열
• 벌크 작업: 여러 작업을 효율적으로 처리함
• 하위 작업: 완료 추적이 가능한 계층적 작업 관리
• 프로젝트 및 섹션: 조직 전면 지원

Todoist MCP Server

An MCP (Model Context Protocol) server that connects Claude with Todoist for complete task and project management through natural language.

Installation

Claude Desktop (One-Click Install)

1. Download todoist-mcp.mcpb from the latest release
2. Double-click the file (or drag onto Claude Desktop)
3. Enter your Todoist API token when prompted
4. Start chatting: “Show me my Todoist projects”

Claude Code / Other MCP Clients

claude mcp add todoist -e TODOIST_API_TOKEN=your_token -- npx @greirson/mcp-todoist

Features

• 19 MCP Tools for complete Todoist management
• Task Management: Create, update, delete, complete, reopen tasks with priorities, due dates, labels
• Bulk Operations: Process multiple tasks efficiently
• Subtasks: Hierarchical task management with completion tracking
• Projects & Sections: Full organization support
• Labels, Filters, Reminders: Pro/Business features supported
• Natural Language: Quick add with Todoist’s natural language parsing
• Dry-Run Mode: Test operations without making changes

Dry-Run Mode

Dry-run mode allows you to test operations and automations without making any real changes to your Todoist workspace. This is perfect for testing, debugging, learning the API, or validating automation scripts before running them for real.

How to Enable Dry-Run Mode

Add DRYRUN=true to your environment configuration:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["@greirson/mcp-todoist"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here",
        "DRYRUN": "true"
      }
    }
  }
}

What Dry-Run Mode Does

• Validates Operations: Uses real API data to validate that operations would succeed
• Simulates Mutations: Create, update, delete, and complete operations are simulated (not executed)
• Real Data Queries: Read operations (get tasks, projects, labels) use the real API
• Detailed Logging: Shows exactly what would happen with clear [DRY-RUN] prefixes
• Error Detection: Catches the same errors that would occur in real execution

Use Cases

• Testing Automations: Validate complex bulk operations before executing