Deja que un agente lleve tu lista de tareas

¿MCP o la CLI?

Prefiere las herramientas MCP cuando tu agente ya tenga una conexión MCP con TaskForge. Están tipadas, devuelven errores estructurados con los que el agente puede autocorregirse, y no necesitan nada en tu PATH. Recurre a la CLI en contextos de shell sin conexión MCP: scripts, cron, CI, o un agente de código que trabaja en una copia local de un repositorio. Ambas funcionan con el mismo motor y con semántica idéntica, así que elige la que ya tengas conectada en tu entorno. Editar los archivos de la bóveda a mano es el último recurso.

Instalación

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

En Windows, antepón cmd /c a npx. Los clientes MCP de escritorio como Claude Desktop inician el servidor sin shell, y npx es un script .cmd que Windows solo ejecuta a través de una:

{
  "mcpServers": {
    "taskforge": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "C:\\path\\to\\your\\vault"
      }
    }
  }
}

¿Compilaste taskforge desde el código fuente en lugar de usar npx? Apunta la configuración directamente al binario:

"command": "taskforge",
"args": ["mcp", "--stdio"]

Solo de escritorio, que es donde viven los clientes MCP. taskforge se distribuye como un único binario nativo para macOS y Windows, y el servidor MCP es uno de sus subcomandos. Linux llegará pronto.

El conjunto completo de herramientas

30 herramientas en total, que cubren todo el ciclo de vida de tareas y notas: crear, leer, actualizar, completar, archivar y eliminar, cada una con su variante en lote; mover, reasignar y convertir entre una tarea en las notas y un archivo de tarea; crear, renombrar, eliminar y editar notas sin romper un enlace; una comprobación de lint antes de escribir una línea; una llamada doctor para revisar la salud de la bóveda; y recursos de dialecto y espacios para que el agente aprenda tu formato antes de actuar. Las seis de abajo son las que más vas a usar. Cada llamada vuelve a leer la bóveda desde el disco, así que el agente siempre actúa sobre los archivos actuales.

Cada herramienta lleva anotaciones, así que un cliente sabe de un vistazo qué llamadas solo leen, cuáles escriben y cuál elimina. El resto del conjunto añade bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_spaces, get_dialect, create_note, read_note, update_note, patch_note_block, patch_note_frontmatter, normalize_references, delete_note y move_note.

Tres recursos

Además de las herramientas, el servidor expone contexto de solo lectura para que el agente aprenda las reglas de tu bóveda antes de actuar:

Si no encuentra tu bóveda

El servidor siempre arranca, incluso antes de saber dónde está tu bóveda, así que Claude Desktop nunca muestra un críptico «error al iniciar el servidor». Cuando una llamada a una herramienta no puede resolver una bóveda, devuelve un error sencillo que el agente puede transmitir: define la variable de entorno TASKFORGE_VAULT con la ruta de tu bóveda, o reinstala el paquete e introduce la carpeta de la bóveda cuando se te pida.

Solo local

El servidor MCP de TaskForge se ejecuta en local y lee y escribe los archivos Markdown de tu bóveda. Instalarlo con npx descarga el paquete desde npm. Tu cliente de IA puede enviar las entradas y los resultados de las herramientas a su proveedor; se aplican sus ajustes de privacidad. Tu sincronización actual de la bóveda lleva las ediciones entre dispositivos.

¿Prefieres una terminal?

Si prefieres automatizar tus tareas con scripts o ejecutar comandos puntuales en lugar de manejarlas desde un agente, la CLI de taskforge cubre la misma bóveda con las mismas reglas.

Preguntas frecuentes