recap-mcp

Recap

Tu gestor de proyectos con IA. Markdown simple. Local primero. Código abierto.

Recap es un servidor MCP que le da a Claude memoria persistente de tus proyectos en curso. Búsquedas de empleo, proyectos paralelos, metas de aprendizaje, esfuerzos de escritura, cualquier cosa en la que trabajes durante semanas o meses. Tus datos viven como archivos markdown simples en una carpeta que tú posees.

Por qué Recap

Claude olvida entre conversaciones. Pasas los primeros cinco minutos de cada chat reexplicando en qué estás trabajando, qué decidiste la última vez y qué está pendiente. Recap soluciona eso.

• Local primero: tu espacio de trabajo es una carpeta de archivos markdown. Nada sale de tu máquina.
• Markdown simple: ábrelo en VS Code, Obsidian, vim, lo que sea.
• Código abierto: licencia MIT, sin bloqueo de proveedor.
• Con forma de proyecto, no de blob: estructurado alrededor de proyectos, tareas, sesiones y notas, no de volcados de memoria opacos.
• Once herramientas enfocadas: sin fregadero de cocina, sin inflado.

Instalación

Requiere Node.js 18+.

npx recap-mcp init

Ese único comando:

1. Crea una carpeta de espacio de trabajo en ~/recap-workspace/
2. Agrega Recap a tu configuración de Claude Desktop
3. Respalda cualquier configuración existente de Claude en .bak

Luego cierra Claude Desktop, vuelve a abrirlo y di "hola". Recap te guiará a través de tu primer proyecto.

Las once herramientas

Herramienta	Propósito
briefing	Ejecutar al inicio de la sesión. Carga el estado del espacio de trabajo, proyectos activos, actividad reciente.
project_list	Listar proyectos, filtrar por estado.
project_create	Iniciar un nuevo proyecto, opcionalmente sembrado desde una plantilla.
project_brief	Cargar contexto completo para un proyecto (descripción, tareas abiertas, sesiones recientes).
task_add	Agregar una tarea con prioridad, fecha de vencimiento y notas opcionales.
task_list	Listar tareas para un proyecto, filtrable por estado.
task_update	Cambiar estado, prioridad, fecha de vencimiento, notas o título.
task_delete	Eliminar una tarea.
session_log	Guardar una entrada de sesión estructurada: en qué se trabajó, decisiones, próximos pasos.
quick_note	Dejar una nota con marca de tiempo en un proyecto.
search	Búsqueda difusa clasificada en todo el espacio de trabajo.

Plantillas

Recap incluye seis plantillas de inicio:

• generic (pizarra limpia)
• job-search
• side-project
• learning
• writing
• moving

Pasa --template a project_create (o haz que Claude lo haga) para sembrar un proyecto con tareas iniciales y un archivo de conocimiento.

Estructura del espacio de trabajo

~/recap-workspace/
├── .recap/
│   └── config.json
├── projects/
│   └── job-search-2026/
│       ├── project.md
│       ├── tasks.md
│       ├── notes.md
│       ├── sessions/
│       │   └── 2026-05-20.md
│       └── knowledge/
│           └── starter.md
└── archived/

Markdown simple con frontmatter YAML. Puedes cd en él y git init si quieres control de versiones. Ábrelo en Obsidian si quieres un visor agradable.

Configuración

La ruta del espacio de trabajo por defecto es ~/recap-workspace/. Sobrescríbela con:

export RECAP_WORKSPACE_PATH=/path/to/your/workspace

O pasa --workspace a recap-mcp init.

Otras configuraciones viven en .recap/config.json:

{
  "version": "0.1.0",
  "briefing": { "recent_days": 14, "max_active_projects": 5 },
  "search": { "max_results": 10 }
}

Solución de problemas

Ejecuta npx recap-mcp doctor para diagnósticos.

Si Claude Desktop no ve Recap después de la instalación:

1. Asegúrate de cerrar Claude Desktop por completo (no solo cerrar la ventana).
2. Verifica que ~/recap-workspace/ exista.
3. Verifica que tu configuración de Claude Desktop tenga la entrada mcpServers.recap.

Privacidad

Recap se ejecuta completamente en tu máquina. No hay telemetría, ni análisis, ni llamadas remotas. Tus proyectos, tareas, notas y registros de sesión nunca salen de tu computadora.

Licencia

MIT. Consulta LICENSE.

Estado

v0.1.0. Temprano. Comentarios y problemas bienvenidos en https://github.com/shivam-singh-git/recap-mcp/issues.