TaskWarrior MCP Server

MCP-сервер, оборачивающий инструмент командной строки TaskWarrior. Предоставляет 22 инструмента для управления задачами, рабочего процесса GTD и отслеживания привычек.

Инструменты

Базовые операции с задачами

• add_task — Создать задачу. Поддерживает поля GTD (context, energy, scheduled, wait, depends) и повторяющиеся задачи (recur)

• modify_task — Обновить атрибуты задачи

• mark_task_done — Завершить задачу по UUID

• delete_task — Удалить задачу по UUID

• list_tasks — Запросить задачи с фильтрами (status, project, tags, dates)

• get_task_details — Получить одну задачу по UUID

• start_task — Запустить таймер на задаче

• stop_task — Остановить таймер на задаче

• add_annotation — Добавить заметку к задаче

• remove_annotation — Удалить заметку из задачи

Зависимости

• add_dependency — Сделать задачу A зависимой от задачи B

• remove_dependency — Удалить связь зависимости

Рабочий процесс GTD

• get_next_actions — Отфильтровать выполнимые задачи по контексту, уровню энергии, доступному времени

• process_inbox — Получить задачи с тегом +inbox для обработки

• get_waiting_for — Получить делегированные/ожидающие задачи, сгруппированные по блокирующему фактору/дате/проекту

• get_blocked_tasks — Получить задачи с невыполненными зависимостями

• get_project_status — Метрики проекта: следующие действия, процент завершения, устаревание

• weekly_review — Данные для обзора GTD: входящие, завершённые, застопорившиеся проекты, привычки

• get_someday_maybe — Получить задачи с тегом +someday

Пакетные операции

• create_project_tree — Создать проект с несколькими задачами и зависимостями одним вызовом

• batch_modify_tasks — Применить одинаковые изменения к нескольким задачам

Привычки/Повторяющиеся задачи

• get_recurring_tasks — Получить повторяющиеся задачи со статистикой завершения, сериями, частотой

Related MCP server: TickTick MCP Server

Требования

• Node.js 18+ для выполнения

• Bun 1.3+ для рабочих процессов разработки

• TaskWarrior установлен и доступен как task

Установка

bun install
bun run build

Запуск

bun run start

Или настройте в параметрах вашего MCP-клиента:

{
  "mcpServers": {
    "taskwarrior": {
      "command": "node",
      "args": ["/path/to/taskwarrior-mcp/dist/index.js"]
    }
  }
}

Пакет для Claude Desktop

Этот репозиторий теперь включает манифест MCPB для Claude Desktop.

bun run mcpb:validate
bun run mcpb:pack

Это создаёт dist/taskwarrior-mcp.mcpb.

Пакет включает MCP-сервер, но не включает сам TaskWarrior. Пользователям по-прежнему нужен task, установленный на хост-машине. Для нестандартных конфигураций манифест MCPB предоставляет опциональные настройки TASK_BIN и TASKRC.

Формат ответа

Все инструменты возвращают стандартный формат MCP:

{
  "content": [
    {
      "type": "text",
      "text": "{\"tasks\": [...], \"metadata\": {...}, \"insights\": {...}}"
    }
  ]
}

Инструменты GTD возвращают расширенные ответы с:

• tasks — Массив объектов задач

• metadata — Счётчики (всего, выполнимых, заблокированных, ожидающих, завершённых)

• insights — Сводка, рекомендации, предупреждения

• groups — Задачи, сгруппированные по проекту/контексту/частоте

• relationships — Цепочки зависимостей (где применимо)

Возможности GTD

Поля задач

• scheduled — Дата начала работы

• wait — Скрывать до даты (отложено)

• until — Задача истекает после даты

• context — Контекст GTD (@home, @work, @phone)

• energy — Требуемый уровень энергии (H/M/L)

• depends — Массив UUID задач, от которых зависит эта

• parent — UUID родительской задачи

• recur — Шаблон повторения (daily, weekly, monthly и т.д.)

• tags — Буквы, цифры, _ и -. Запись тегов использует атрибут tags: Taskwarrior, а фильтры тегов используют tags.has:, потому что сокращение +tag отклоняет дефисы и молча переписывает описание.

Повторяющиеся задачи

Установите recur вместе с due, чтобы создать привычки:

{
  "description": "Take vitamins",
  "recur": "daily",
  "due": "today",
  "context": "@morning"
}

TaskWarrior создаёт шаблонную задачу (status:recurring), которая генерирует экземпляры. Используйте get_recurring_tasks, чтобы увидеть показатели завершения и серии.

Разработка

bun run typecheck  # Type check source
bun run lint       # Lint source
bun run test       # Run integration tests against disposable Taskwarrior data
bun run build      # Build dist/
bun run check      # Run typecheck, lint, tests, and build