TaskWarrior 명령줄 도구를 감싸는 MCP 서버. 작업 관리, GTD 워크플로우 및 습관 추적을 위한 22개의 도구를 제공합니다.

도구

기본 작업 운영

• add_task - 작업 만들기. GTD 필드 지원 (컨텍스트, 에너지, 예정, 대기, 의존) 및 반복 작업 (recur)
• modify_task - 작업 속성 업데이트
• mark_task_done - UUID로 작업 완료
• delete_task - UUID로 작업 삭제
• list_tasks - 필터(status, project, tags, date)로 쿼리 작업
• get_task_details - UUID로 단일 작업을 가져옵니다
• start_task - 작업 시작 타이머
• stop_task - 작업 중지 타이머
• add_annotation - 작업에 대한 메모 추가
• remove_annotation - 작업에서 메모 제거

종점

• add_dependency - 작업 A는 작업 B에 의존
• remove_dependency - 신뢰할 수 있는 링크 제거

GTD 워크 플로우

• get_next_actions - context, 에너지 레벨, 시간별 필터 작업 가능
• process_inbox - 작업 태그 +inbox 처리
• get_waiting_for - Blocker/date/project에 의해 그룹화된 위임/waiting 작업을 가져옵니다.
• get_blocked_tasks - unmet Dependencies로 작업하기
• get_project_status - 프로젝트 메트릭 : 다음 작업, 완료 %, staleness

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 includes explicit ES module metadata so its JavaScript entry loads on Node 18 as well as newer Node versions.

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