TaskWarrior MCP Server
TaskWarrior MCP Server
MCP-сервер, оборачивающий инструмент командной строки TaskWarrior. Предоставляет 22 инструмента для управления задачами, рабочего процесса GTD и отслеживания привычек.
Инструменты
Базовые операции с задачами
add_task— Создать задачу. Поддерживает поля GTD (context, energy, scheduled, wait, depends) и повторяющиеся задачи (recur)modify_task— Обновить атрибуты задачиmark_task_done— Завершить задачу по UUIDdelete_task— Удалить задачу по UUIDlist_tasks— Запросить задачи с фильтрами (status, project, tags, dates)get_task_details— Получить одну задачу по UUIDstart_task— Запустить таймер на задачеstop_task— Остановить таймер на задачеadd_annotation— Добавить заметку к задачеremove_annotation— Удалить заметку из задачи
Зависимости
add_dependency— Сделать задачу A зависимой от задачи Bremove_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 buildTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
ADHD-friendly task management MCP server for ChaTodo: organize tasks, lists, and priorities.
MCP server for Google Tasks: review, plan and tidy your tasks by asking. Deletes always ask first.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables AI assistants to interact with the Taskwarrior command-line task management tool. It allows users to list, create, modify, and organize tasks using projects, tags, and annotations through natural language.132MIT
- FlicenseNot gradedqualityDmaintenanceRemote MCP server for managing TickTick tasks and projects, offering 22 tools for CRUD, search, and GTD workflows via any MCP client.1-
- AlicenseAqualityCmaintenanceMCP server for Taskwarrior 3.x — 35 tools for task lifecycle, time tracking, schema validation, and role-based permissions.3574 PyPI3Apache 2.0
- AlicenseNot gradedqualityDmaintenanceAn MCP server that wraps the Taskwarrior CLI to allow AI assistants to create, query, modify, and manage tasks directly from agentic coding tools.MIT