Claude와 Todoist를 통합하여 자연어 작업 관리를 가능하게 하는 MCP(Model Context Protocol) 서버 구현체입니다. 이 서버는 Claude가 일상 언어를 사용해 Todoist 작업과 상호작용할 수 있게 합니다.

특징

• 자연어 작업 관리: 일상 언어를 사용해 작업을 생성, 업데이트, 완료 및 삭제
• 스마트 작업 검색: 부분 이름 일치를 이용한 작업 찾기
• 유연한 필터링: 마감일, 우선순위 및 기타 속성으로 작업 필터링
• 풍부한 작업 세부 정보: 설명, 마감일, 우선순위 수준 지원
• 직관적인 오류 처리: 더 나은 사용자 경험을 위한 명확한 피드백

설치

Smithery를 통해 설치 중

Smithery를 통해 Claude Desktop용 Todoist MCP 서버를 자동으로 설치하려면:

수동 설치

도구

todoist_create_task

다양한 속성을 가진 새로운 작업을 생성하세요:

• 필수: 내용 (작업 제목)
• 선택 사항: 설명, 마감일, 우선순위 수준 (1-4)
• 예시: “‘주간 동기화’ 설명이 내일 마감인 작업 ‘팀 미팅’ 생성”

todoist_get_tasks

작업 검색 및 필터링:

• 마감일, 우선순위 또는 프로젝트별로 필터링
• 자연어 날짜 필터링

Todoist MCP Server

An MCP (Model Context Protocol) server implementation that integrates Claude with Todoist, enabling natural language task management. This server allows Claude to interact with your Todoist tasks using everyday language.

Features

• Natural Language Task Management: Create, update, complete, and delete tasks using everyday language
• Smart Task Search: Find tasks using partial name matches
• Flexible Filtering: Filter tasks by due date, priority, and other attributes
• Rich Task Details: Support for descriptions, due dates, and priority levels
• Intuitive Error Handling: Clear feedback for better user experience

Installation

Installing via Smithery

To install Todoist MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

Manual Installation

npm install -g @abhiz123/todoist-mcp-server

Tools

todoist_create_task

Create new tasks with various attributes:

• Required: content (task title)
• Optional: description, due date, priority level (1-4)
• Example: “Create task ‘Team Meeting’ with description ‘Weekly sync’ due tomorrow”

todoist_get_tasks

Retrieve and filter tasks:

• Filter by due date, priority, or project
• Natural language date filtering
• Optional result limit
• Example: “Show high priority tasks due this week”

todoist_update_task

Update existing tasks using natural language search:

• Find tasks by partial name match
• Update any task attribute (content, description, due date, priority)
• Example: “Update meeting task to be due next Monday”

todoist_complete_task

Mark tasks as complete using natural language search:

• Find tasks by partial name match
• Confirm completion status
• Example: “Mark the documentation task as complete”

todoist_delete_task

Remove tasks using natural language search:

• Find and delete tasks by name
• Confirmation messages
• Example: “Delete the PR review task”

Setup

Getting a Todoist API Token

1. Log in to your Todoist account
2. Navigate to Settings → Integrations
3. Find your API token under “Developer”

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Example Usage

Creating Tasks

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"