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

Инструменты

###Основные задачи

• [[Т0]] - Создание задания. Поддержка полей GTD (контекст, энергия, расписание, ожидание, зависимость) и повторяющиеся задачи (повторение) modify_task - Обновление атрибутов задачи mark_task_done - Полное задание UUID
• delete_task - Исключить задачу UUID
• list_tasks - Задачи запросов с фильтрами (статус, проект, теги, даты) get_task_details - Выполняйте одну задачу с помощью UUID start_task - Старт таймера по заданию stop_task - Остановить таймер на задание [8] - Добавить примечание к заданию [9] - Удалить записку с задания

Зависимости

add_dependency - Задайте задачу А в зависимости от задачи В remove_dependency - Удалить ссылку на зависимость

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

• get_next_actions - Фильтр для решения задач по контексту, уровню энергии, времени process_inbox - Получить задачи помеченные +inbox для обработки
• get_waiting_for - Получить делегированные задачи ожидания, сгруппированные по блокировщику/дате/проекту get_blocked_tasks - Получать задания с нереализованными зависимостями get_project_status - Метрики проекта: следующие действия, процент завершения, застойность

TaskWarrior MCP Server

MCP server that wraps TaskWarrior command-line tool. Provides 22 tools for task management, GTD workflow, and habit tracking.

Tools

Basic Task Operations

• add_task - Create task. Supports GTD fields (context, energy, scheduled, wait, depends) and recurring tasks (recur)
• modify_task - Update task attributes
• mark_task_done - Complete task by UUID
• delete_task - Delete task by UUID
• list_tasks - Query tasks with filters (status, project, tags, dates)
• get_task_details - Get single task by UUID
• start_task - Start timer on task
• stop_task - Stop timer on task
• add_annotation - Add note to task
• remove_annotation - Remove note from task

Dependencies

• add_dependency - Make task A depend on task B
• remove_dependency - Remove dependency link

GTD Workflow

• get_next_actions - Filter actionable tasks by context, energy level, time available
• process_inbox - Get tasks tagged +inbox for processing
• get_waiting_for - Get delegated/waiting tasks, grouped by blocker/date/project
• get_blocked_tasks - Get tasks with unmet dependencies
• get_project_status - Project metrics: next actions, completion %, staleness
• weekly_review - GTD review data: inbox, completed, stalled projects, habits
• get_someday_maybe - Get tasks tagged +someday

Batch Operations

• create_project_tree - Create project with multiple tasks and dependencies in one call
• batch_modify_tasks - Apply same modifications to multiple tasks

Habits/Recurring Tasks

• get_recurring_tasks - Get recurring tasks with completion stats, streaks, frequency

Requirements

• Node.js 18+ for runtime
• Bun 1.3+ for development workflows
• TaskWarrior installed and available as task

Install

bun install
bun run build

Run

bun run start

Or configure in your MCP client settings:

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

Claude Desktop Bundle

This repo now includes an MCPB manifest for Claude Desktop.

bun run mcpb:validate
bun run mcpb:pack

That produces dist/taskwarrior-mcp.mcpb.

The bundle packages the MCP server, but it does not bundle TaskWarrior itself. Users still need task installed on the host machine. For non-default setups, the MCPB manifest exposes optional TASK_BIN and TASKRC settings.

Response Format

All tools return MCP standard format:

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

GTD tools return enriched responses with:

• tasks - Array of task objects
• metadata - Counts (total, actionable, blocked, waiting, completed)
• insights - Summary, recommendations, warnings
• groups - Tasks grouped by project/context/frequency
• relationships - Dependency chains (where applicable)

GTD Features