Deja que un agente maneje 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 agrega, busca, edita y completa tareas mediante un pequeño conjunto de herramientas. Se ejecuta en tu computadora y edita los mismos archivos markdown que la app. Sin servidor alojado, sin clave de API.
Muy pronto en TaskForge 3.0
El CLI y el servidor MCP de TaskForge llegan con el lanzamiento de TaskForge 3.0. Todo lo que ves en esta página describe cómo van a funcionar cuando estén disponibles. La app de TaskForge ya está disponible para descargar hoy.
¿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 usan 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.
Instalar
Recomendado: npx
Agrega 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 guía 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, porque ahí 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 revisió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. | read-only |
| get_task | Lee una tarea y su hash de contenido. Solo lectura. | read-only |
| add_task | Crea una tarea en el destino predeterminado del vault, con tu formato. | writes |
| update_task | Cambia el estado, la prioridad, la fecha de vencimiento, el título o las etiquetas de una tarea. | writes |
| complete_task | Completa una tarea; devuelve la siguiente ocurrencia si es recurrente. | writes, not idempotent |
| delete_task | Elimina una tarea. El modelo debe repetir exactamente el título actual, como resguardo contra actuar sobre un id desactualizado o inventado. | destructive |
Cada herramienta ahora lleva anotaciones, así que un cliente sabe de un vistazo cuáles llamadas solo leen, cuáles escriben y cuál elimina. El resto del conjunto agrega 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
Junto con 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 agregar 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 tu formato exacto de tareas. Abre el vault en TaskForge 3.0 o posterior al menos una vez, ve a Configuración, IA y agentes, y deja activado "Generar archivos para agentes". Si el vault nunca se abrió en una versión reciente, el servidor recurre a valores genéricos por defecto 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 "el servidor no pudo iniciarse". 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 ingresa 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 existente, iCloud, Dropbox u Obsidian Sync, mueve los cambios entre dispositivos.
¿Prefieres una terminal?
Si quieres programar tus tareas o ejecutar comandos puntuales en lugar de manejarlos desde un agente, la CLI de taskforge cubre el mismo vault con las mismas reglas.
Instalar 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á agregar, 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 computadora 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 ingresa 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 genéricos por defecto y avisa al cliente 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