Deja que un agente lleve tu lista de tareas
¿Buscas un servidor MCP de tareas que actúe sobre archivos reales en lugar de una base de datos alojada en la nube? taskforge incluye uno como subcomando, taskforge mcp --stdio, para tu vault de Obsidian. Apunta Claude Desktop u otro cliente MCP hacia él y el agente añade, busca, edita y completa tareas mediante un pequeño conjunto de herramientas. Se ejecuta en tu ordenador y edita los mismos archivos markdown que la app. Sin servidor alojado, sin clave de API.
Próximamente en TaskForge 3.0
La CLI y el servidor MCP de TaskForge llegan con el lanzamiento de TaskForge 3.0. Todo lo que aparece en esta página describe cómo funcionarán cuando estén disponibles. La app de TaskForge ya se puede descargar hoy mismo.
¿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 mueven el mismo motor con semántica idéntica, así que elige la que ya tengas conectada en tu entorno. Editar los archivos del vault a mano es el último recurso.
Instalación
Recomendado: npx
Añade esto a la configuración de tu cliente MCP. npx descarga taskforge-md la primera vez que se ejecuta, así que no hay nada que instalar de antemano.
Claude Desktop, con un clic
¿Prefieres una instalación guiada? Descarga el paquete de taskforge (el archivo .mcpb) y ábrelo. Claude Desktop te lleva paso a paso y te pide la carpeta de tu vault.
{
"mcpServers": {
"taskforge": {
"command": "npx",
"args": ["-y", "taskforge-md", "mcp", "--stdio"],
"env": {
"TASKFORGE_VAULT": "/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, Windows y Linux, y el servidor MCP es uno de sus subcomandos.
El conjunto completo de herramientas
22 herramientas en total, que cubren todo el ciclo de vida de una tarea: crear, leer, actualizar, completar, archivar y eliminar, cada una con su variante en lote; mover, reasignar y convertir entre una línea en línea y un archivo TaskNotes; una comprobación de lint antes de escribir una línea; una llamada doctor para revisar la salud del vault; y recursos de esquema y listas 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 el vault desde el disco, así que el agente siempre actúa sobre los archivos actuales.
| query_tasks | Busca y filtra tareas, o lee una lista guardada. Solo lectura. | solo lectura |
| get_task | Lee una tarea y su hash de contenido. Solo lectura. | solo lectura |
| add_task | Crea una tarea en el destino predeterminado del vault, con tu formato. | escribe |
| update_task | Cambia el estado, la prioridad, la fecha de vencimiento, el título o las etiquetas de una tarea. | escribe |
| complete_task | Completa una tarea; devuelve la siguiente aparición si es recurrente. | escribe, no idempotente |
| delete_task | Elimina una tarea. El modelo debe repetir exactamente el título actual, una salvaguarda contra actuar sobre un id obsoleto o alucinado. | destructivo |
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_task_lists y get_schema.
Tres recursos
Además de las herramientas, el servidor expone contexto de solo lectura para que el agente aprenda las reglas de tu vault antes de actuar:
| taskforge://schema | El dialecto de tareas legible por máquina: símbolos de estado, formato de fecha, campos personalizados, destinos de escritura. |
| taskforge://agents-guide | La guía en lenguaje sencillo de las convenciones de tareas de tu vault. |
| taskforge://lists | Tus listas de tareas guardadas y cómo añadir una tarea a cada una. |
Un solo requisito: el contrato del vault
El servidor lee los archivos de contrato que TaskForge escribe en tu vault, taskforge/schema.json y taskforge/agents.md, para aprender el formato exacto de tus tareas. Abre el vault en TaskForge 3.0 o posterior al menos una vez, ve a Ajustes, IA y Agentes, y deja activado "Generar archivos para agentes". Si el vault nunca se ha abierto en una versión reciente, el servidor recurre a valores por defecto genéricos y avisa al cliente.
Si no encuentra tu vault
El servidor siempre arranca, incluso antes de saber dónde está tu vault, así que Claude Desktop nunca muestra un opaco "error al iniciar el servidor". Cuando una llamada a una herramienta no puede resolver un vault, devuelve un error sencillo que el agente puede transmitir: define la variable de entorno TASKFORGE_VAULT con la ruta de tu vault, o reinstala el paquete e introduce la carpeta del vault cuando se te pida.
Solo local
taskforge mcp --stdio lee y escribe los archivos markdown del vault que configures, y nada más. Sin cuenta, sin nube. Tu sincronización actual, iCloud, Dropbox u Obsidian Sync, mueve los cambios 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 el mismo vault con las mismas reglas.
Instala la CLI de taskforge →Preguntas frecuentes
¿Qué es el servidor MCP de taskforge?
Es un servidor local de Model Context Protocol integrado en el binario de taskforge. Ejecútalo con taskforge mcp --stdio y un cliente MCP como Claude Desktop podrá añadir, buscar, editar, mover, completar y eliminar las tareas de tu vault de Obsidian mediante 22 herramientas tipadas, una a una o por lotes. Es una lista de tareas sobre la que tu agente puede actuar, no solo leer.
¿Con qué clientes MCP funciona?
Con cualquier cliente que hable MCP por stdio. Claude Desktop es el más común, y Claude Code, Cursor y VS Code (para GitHub Copilot) usan la misma configuración. Cada uno obtiene las mismas 22 herramientas y los mismos tres recursos.
¿Es un servidor MCP alojado o remoto?
No. Se ejecuta en tu máquina por stdin y stdout y solo toca la carpeta del vault que le indiques. No hay URL que alojar, ni clave de API, ni cuenta de TaskForge. Ese es el punto: tu lista de tareas se queda en tu disco.
¿Necesito instalar algo?
No de antemano. Apunta la configuración de tu cliente a npx -y taskforge-md mcp --stdio y npx descarga el paquete la primera vez que se ejecuta. Los usuarios de Claude Desktop pueden en cambio abrir el paquete .mcpb para una instalación guiada.
El cliente dice que el servidor no encuentra mi vault. ¿Ahora qué?
El servidor siempre arranca, así que el cliente nunca muestra un opaco "failed to start". Cuando una llamada a una herramienta no puede resolver un vault, devuelve un mensaje sencillo: define la variable de entorno TASKFORGE_VAULT con la ruta de tu vault, o reinstala el paquete e introduce la carpeta del vault cuando se te pida.
¿Necesita los archivos de contrato del vault?
Sí, para ajustarse a tu formato. Lee taskforge/schema.json y taskforge/agents.md, generados cuando abres el vault en TaskForge 3.0 o posterior con "Generar archivos para agentes" activado. Sin ellos igual funciona, pero recurre a valores por defecto genéricos y avisa al cliente de que está adivinando.
El agente actúa sobre la lista. La app la conserva.
El servidor MCP escribe en tu vault; TaskForge convierte esos archivos en listas, widgets y recordatorios en todos tus dispositivos. Gratis para descargar en iPhone, iPad, Mac y Android.
Gratis - iOS y Mac 
Gratis - Android