TaskWarrior MCP Server

TaskWarrior 명령줄 도구를 래핑하는 MCP 서버입니다. 작업 관리, GTD 워크플로, 습관 추적을 위한 22가지 도구를 제공합니다.

도구

기본 작업 연산

• 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 번들

이 저장소에는 이제 Claude Desktop용 MCPB 매니페스트가 포함되어 있습니다.

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 - 개수(total, actionable, blocked, waiting, completed)

• insights - 요약, 권장 사항, 경고

• groups - 프로젝트/컨텍스트/빈도별로 그룹화된 작업

• relationships - 종속성 체인(해당되는 경우)

GTD 기능

작업 필드

• scheduled - 작업을 시작할 날짜

• wait - 날짜까지 숨김(지연됨)

• until - 날짜 이후 작업 만료

• context - GTD 컨텍스트(@home, @work, @phone)

• energy - 필요한 에너지 수준(H/M/L)

• depends - 이 작업이 의존하는 작업 UUID 배열

• parent - 상위 작업 UUID

• recur - 반복 패턴(매일, 매주, 매월 등)

• tags - 문자, 숫자, _ 및 -. 태그 쓰기는 Taskwarrior의 tags: 속성을 사용하고 태그 필터는 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