todoist-mcp

Возможности

• Полная интеграция с API Todoist: Доступ к полному REST API v2 Todoist и поддержка Sync API Todoist через естественный язык

• Пакетная обработка: Клиент может обрабатывать несколько задач в одном запросе

• Поиск по названию: ИИ может искать задачи, проекты и метки по названию, а не по ID

• Задачи: Создание, обновление, закрытие, повторное открытие, перемещение и удаление задач с использованием разговорного языка

• Проекты: Создание и управление проектами и разделами

• Комментарии: Добавление и управление комментариями к задачам и проектам

• Метки: Создание и управление личными и общими метками

• Поддержка промптов: Вы можете легко предоставлять клиенту информацию о своих проектах

Related MCP server: Notion API MCP Server

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

Для использования этого MCP-сервера вам понадобится API-токен Todoist.

Получение API-токена Todoist

1. Войдите в свою учетную запись Todoist

2. Перейдите в «Настройки» → «Интеграции»

3. Найдите свой API-токен в разделе «Разработчик»

Использование

Добавьте в mcpServers в конфигурации вашей платформы:

"todoist": {
    "command": "npx",
    "args": ["-y", "todoist-mcp"],
    "env": { "API_KEY": "your_todoist_api_token" }
}

Codex — CLI:

codex mcp add todoist --env API_KEY=your_token -- npx -y todoist-mcp

Или добавьте в config.toml:

[mcp_servers.todoist]
command = "npx"
args = ["-y", "todoist-mcp"]

[mcp_servers.todoist.env]
API_KEY = "your_todoist_api_token"

Доступные инструменты

Задачи

• get_tasks_list: Получение списка задач с опциональной фильтрацией по проекту, разделу, метке или ID

• get_tasks_by_filter: Получение задач с использованием языка фильтров Todoist (например, "today", "overdue", "P1 | P2", "#Work & @urgent")

• create_tasks: Создание новых задач с различными атрибутами

• get_tasks: Получение конкретных задач по ID или названию

• update_tasks: Обновление существующих задач

• close_tasks: Отметка задач как выполненных

• reopen_tasks: Повторное открытие выполненных задач

• delete_tasks: Удаление задач

• move_tasks: Перемещение задач в другой проект или раздел

Проекты

• get_projects_list: Получение всех проектов

• create_projects: Создание новых проектов

• get_projects: Получение конкретных проектов по ID или названию

• update_projects: Обновление существующих проектов

• delete_projects: Удаление проектов

• get_collaborators: Получение всех соавторов проекта

• move_projects: Перемещение проектов в другое место или подпроект

Разделы

• get_sections_list: Получение всех разделов или фильтрация по проекту

• create_sections: Создание новых разделов

• get_sections: Получение конкретных разделов по ID или названию

• update_sections: Обновление разделов

• delete_sections: Удаление разделов

Комментарии

• get_comments_list: Получение комментариев к проекту или задаче

• create_comments: Создание новых комментариев

• get_comments: Получение конкретных комментариев по ID

• update_comments: Обновление комментариев

• delete_comments: Удаление комментариев

Метки

• get_labels_list: Получение всех личных меток

• create_labels: Создание новых личных меток

• get_labels: Получение личных меток по ID или названию

• update_labels: Обновление личных меток

• delete_labels: Удаление личных меток

• get_shared_labels: Получение всех общих меток

• rename_shared_labels: Переименование общих меток

• remove_shared_labels: Удаление общих меток

Утилиты

• utils_get_colors: Получение доступных цветов для проектов, меток, фильтров

Промпты

• projects_list: Получение списка проектов с их разделами и параметрами в формате markdown

Пример использования

Задавайте своему ИИ-ассистенту (например, Claude) вопросы вроде:

"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"

Разработка

# Install dependencies
npm install

# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Проблемы и поддержка

Если вы столкнулись с какими-либо проблемами или вам нужна поддержка, пожалуйста, создайте issue в репозитории GitHub.