GM

greirson/mcp-todoist

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

246 stars 32 forks Качество 73 Тренд 18MIT

greirson/mcp-todoist — это кандидат на MCP-сервер, импортированный из https://github.com/greirson/mcp-todoist.

Обзор

greirson/mcp-todoist — это кандидат на MCP-сервер, импортированный из https://github.com/greirson/mcp-todoist.

Обзор (машинный перевод)

Сервер MCP (Model Context Protocol), который соединяет Claude с Todoist для полного управления задачами и проектами через естественный язык.

Установка

Claude Desktop (установка в один клик)

  1. Скачайте todoist-mcp.mcpb из последнего релиза
  2. Дважды кликните по файлу (или перетащите на Claude Desktop)
  3. Введите свой токен API Todoist по запросу
  4. Начните общаться: “Покажи мне мои проекты Todoist”

Claude Code / Другие клиенты MCP

Ручная конфигурация JSON

Добавьте в конфигурацию вашего клиента MCP (claude_desktop_config.json, ~/.claude.json и т.д.):

Конфигурационные локации:

  • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
  • Код Клода: ~/.claude.json

Особенности

  • 19 MCP Tools для полного управления Todoist
  • Управление задачами: Создание, обновление, удаление, завершение, повторное открытие задач с приоритетами, сроками, метками
  • Bulk Operations: эффективная обработка нескольких задач
  • Подзадачи: Иерархическое управление задачами с отслеживанием завершения
  • Проекты и секции: Полная поддержка организации

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

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
Открыть полный README на GitHub

Установка

npx @greirson/mcp-todoist
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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