TaskWarrior MCP Server

Servidor MCP que envuelve la herramienta de línea de comandos TaskWarrior. Proporciona 22 herramientas para gestión de tareas, flujo de trabajo GTD y seguimiento de hábitos.

Herramientas

Operaciones básicas de tareas

• add_task - Crear tarea. Admite campos GTD (context, energy, scheduled, wait, depends) y tareas recurrentes (recur)

• modify_task - Actualizar atributos de tarea

• mark_task_done - Completar tarea por UUID

• delete_task - Eliminar tarea por UUID

• list_tasks - Consultar tareas con filtros (status, project, tags, dates)

• get_task_details - Obtener una tarea por UUID

• start_task - Iniciar temporizador en tarea

• stop_task - Detener temporizador en tarea

• add_annotation - Añadir nota a tarea

• remove_annotation - Eliminar nota de tarea

Dependencias

• add_dependency - Hacer que la tarea A dependa de la tarea B

• remove_dependency - Eliminar enlace de dependencia

Flujo de trabajo GTD

• get_next_actions - Filtrar tareas accionables por contexto, nivel de energía, tiempo disponible

• process_inbox - Obtener tareas etiquetadas +inbox para procesar

• get_waiting_for - Obtener tareas delegadas/en espera, agrupadas por bloqueador/fecha/proyecto

• get_blocked_tasks - Obtener tareas con dependencias no cumplidas

• get_project_status - Métricas del proyecto: próximas acciones, % de finalización, antigüedad

• weekly_review - Datos de revisión GTD: bandeja de entrada, completados, proyectos estancados, hábitos

• get_someday_maybe - Obtener tareas etiquetadas +someday

Operaciones por lotes

• create_project_tree - Crear proyecto con múltiples tareas y dependencias en una sola llamada

• batch_modify_tasks - Aplicar las mismas modificaciones a múltiples tareas

Hábitos/Tareas recurrentes

• get_recurring_tasks - Obtener tareas recurrentes con estadísticas de finalización, rachas, frecuencia

Related MCP server: TickTick MCP Server

Requisitos

• Node.js 18+ para el tiempo de ejecución

• Bun 1.3+ para flujos de trabajo de desarrollo

• TaskWarrior instalado y disponible como task

Instalación

bun install
bun run build

Ejecutar

bun run start

O configúralo en la configuración de tu cliente MCP:

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

Paquete Claude Desktop

Este repositorio ahora incluye un manifiesto MCPB para Claude Desktop.

bun run mcpb:validate
bun run mcpb:pack

Eso produce dist/taskwarrior-mcp.mcpb.

El paquete incluye el servidor MCP, pero no incluye TaskWarrior en sí. Los usuarios aún necesitan task instalado en la máquina host. Para configuraciones no predeterminadas, el manifiesto MCPB expone ajustes opcionales TASK_BIN y TASKRC.

Formato de respuesta

Todas las herramientas devuelven el formato estándar MCP:

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

Las herramientas GTD devuelven respuestas enriquecidas con:

• tasks - Matriz de objetos de tarea

• metadata - Conteos (total, accionables, bloqueadas, en espera, completadas)

• insights - Resumen, recomendaciones, advertencias

• groups - Tareas agrupadas por proyecto/contexto/frecuencia

• relationships - Cadenas de dependencia (cuando corresponda)

Características GTD

Campos de tarea

• scheduled - Fecha para comenzar el trabajo

• wait - Ocultar hasta la fecha (diferido)

• until - La tarea expira después de la fecha

• context - Contexto GTD (@home, @work, @phone)

• energy - Nivel de energía requerido (H/M/L)

• depends - Matriz de UUIDs de tareas de las que depende

• parent - UUID de la tarea principal

• recur - Patrón de recurrencia (diario, semanal, mensual, etc.)

• tags - Letras, dígitos, _ y -. Las escrituras de etiquetas usan el atributo tags: de Taskwarrior y los filtros de etiquetas usan tags.has:, porque la abreviatura +tag rechaza guiones y reescribe silenciosamente la descripción.

Tareas recurrentes

Establece recur con due para crear hábitos:

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

TaskWarrior crea una tarea plantilla (status:recurring) que genera instancias. Usa get_recurring_tasks para ver tasas de finalización y rachas.

Desarrollo

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