episteme
Stores all knowledge — memories, documentation, and plans — as plain Markdown note files organized in zones, which can be read and edited with any editor and indexed for search.
The server reads and writes a vault of Markdown notes that can be opened and edited directly in Obsidian, letting the agent persist and retrieve project documentation, decisions, and lessons alongside a human-curated Obsidian vault.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

episteme
Documentación y memoria de proyectos para agentes, servida por MCP desde un vault Markdown
Qué es
Claude Code es como un colega brillante que cada mañana llega sin recordar nada de ayer.
Claude Code empieza cada sesión sin recordar la anterior. episteme le da una memoria que dura: una carpeta de notas en Markdown (el vault) donde quedan las decisiones, las lecciones y la documentación de tus proyectos, y que Claude consulta y completa mientras trabaja.
Qué hace por ti | |
Recuerda | Guarda decisiones, lecciones, errores y preferencias como notas ordenadas por proyecto |
Encuentra | Busca en todo el vault, en español, sin distinguir mayúsculas ni tildes |
Avisa a tiempo | Antes de editar un archivo, muestra las normas que le aplican; después, lo que ya se sabe de él |
Retoma | Guarda en qué ibas antes de que la conversación se compacte y lo recupera después |
Cuida el orden | Detecta duplicados, memorias vencidas, enlaces rotos y memorias sin enlazar; rechaza guardar contraseñas y tokens |
Las notas son archivos de texto tuyos: se abren con Obsidian o con cualquier editor, y no dependen de ningún servicio externo.
Versión actual: v0.13.2. Funciona en Linux, macOS y Windows. Las novedades de cada versión están en el CHANGELOG.
Related MCP server: vault-mcp
Cómo funciona
Claude Code habla con episteme de dos formas: el agente usa sus herramientas cuando las necesita, y los hooks las llaman solos en momentos fijos de la sesión.
episteme es un programa pequeño que corre en tu máquina. Es la única puerta al vault: valida lo que se guarda y mantiene un índice para buscar rápido.
El vault es una carpeta de notas Markdown, por defecto
~/.episteme. Tú puedes leerlo y editarlo con Obsidian.
Término | Qué significa |
Vault | La carpeta con todas las notas. Se divide en zonas: documentación, memorias, planes |
Memoria | Una nota corta con algo que vale la pena recordar: una decisión, una lección, un recordatorio |
Herramienta (tool) | Una acción que Claude puede pedirle a episteme: buscar, leer, guardar |
Hook | Un automatismo de Claude Code que llama a una herramienta sin que nadie lo pida |
MCP | El protocolo estándar con el que Claude Code se conecta a programas como episteme |
Instalación
Necesitas uv y git. uv consigue Python por ti si falta.
Opción A · Con la skill (recomendada)
Las skills vienen en un plugin de Claude Code. Se instala una vez por máquina, con dos comandos (igual en Linux, macOS y Windows):
claude plugin marketplace add Bajmein/episteme
claude plugin install episteme@epistemeMás detalles (actualizar, quitar) en la guía de instalación.
Después, en cada proyecto que quieras conectar:
Reinicia Claude Code y ábrelo en la raíz del proyecto.
Escribe
/episteme:setup.Aprueba los cambios que te muestra. La skill registra el servidor, configura los hooks y los permisos, y añade la regla al
CLAUDE.md.
El plugin trae además estas skills:
Skill | Para qué |
| Guardar en qué estabas antes de |
| Revisar las memorias contigo: unificar las repetidas, resolver contradicciones y archivar lo vencido. Con |
| Dejar un recordatorio que sale al empezar cada sesión del proyecto |
Opción B · A mano
Un solo comando registra el servidor. Cambia <proyecto> por el nombre del tuyo.
Linux y macOS
claude mcp add --scope local episteme -- \
uvx --from git+https://github.com/Bajmein/episteme@v0.13.2 episteme --project <proyecto>Windows (PowerShell, en una sola línea)
claude mcp add --scope local episteme -- uvx --from git+https://github.com/Bajmein/episteme@v0.13.2 episteme --project <proyecto>Luego faltan los hooks, los permisos y la regla del CLAUDE.md: los pasos están en la guía de instalación.
Para comprobar que quedó bien,claude mcp list debe mostrar episteme conectado. La primera vez tarda un poco, porque se descarga. Para actualizar, repite el registro con el tag nuevo.
Uso diario
No hay comandos que aprender: se usa conversando con Claude.
Tú | episteme |
Empiezas una sesión | Le entrega a Claude las normas del proyecto, los recordatorios vencidos y las memorias más importantes |
Escribes un mensaje | Sugiere las memorias que vienen al caso |
Dices «recuerda que…» | Guarda una memoria nueva, salvo que ya exista una casi igual |
Preguntas «¿qué decidimos sobre…?» | Claude busca en el vault antes de responder |
Claude va a editar un archivo | Le muestra las normas que aplican a ese archivo |
La conversación se compacta o la limpias con | Al compactar guarda el estado del trabajo; en los dos casos lo recupera al seguir |
Lo que pasa solo en cada sesión
Los hooks nunca bloquean a Claude ni deciden por él: solo le acercan contexto. Funcionan como un semáforo, no como un muro: Claude puede leer la norma y aun así equivocarse. La configuración está en Hooks.
Quién hace qué y cuándo
Cuándo | Quién | Qué pasa |
Al escribir un mensaje | hook | La primera vez entrega la bienvenida; después sugiere memorias que vienen al caso |
Antes de editar un archivo | hook | Muestra las normas de ese archivo. No pausa ni bloquea la edición |
Después de leer o editar un archivo | hook | Muestra lo que ya se sabe de él |
Al compactar o con | hook | Al compactar guarda el estado del trabajo; después de compactar o de |
En la primera bienvenida, como mucho una vez por periodo | episteme | Avisa de lo pendiente de revisar y propone una ronda corta; si lo activas, archiva lo vencido y hace un backup |
Cuando lo necesita | Claude | Busca, lee, guarda («recuerda que…») y corrige memorias |
Cuando tú lo pides | tú |
|
Guardar una memoria siempre lo decide Claude: ningún hook copia lo que escribes. episteme no revisa el vault en segundo plano: la revisión corre cuando alguien la pide.
Las 10 herramientas
Herramienta | Para qué sirve | Escribe |
| Buscar en las notas y las memorias | |
| Leer una nota, una sección o varias notas a la vez | |
| Ver qué notas enlazan con otra | |
| Dar la bienvenida de la sesión y reunir lo relevante para una tarea | ● |
| Mostrar lo que se sabe de un archivo | |
| Mostrar las normas que aplican a un archivo | |
| Guardar una memoria nueva; avisa si le faltan palabras clave o enlaces | ● |
| Corregir, reemplazar o archivar una nota | ● |
| Revisar el vault: duplicados, vencidas, enlaces rotos y memorias sueltas, con sugerencias de a qué enlazarlas | |
| Guardar y recuperar el estado del trabajo | ● |
Los parámetros y el comportamiento exacto de cada una están en Tools y memorias.
Tipos de memoria
Tipo | Qué guarda |
| Algo que se decidió y por qué |
| Una norma que hay que respetar al tocar ciertos archivos |
| Algo aprendido que conviene repetir o evitar |
| Un fallo y cómo se resolvió |
| Cómo le gusta trabajar a la persona |
| Un hallazgo o una conclusión |
| Algo pendiente, con fecha |
| El estado del trabajo, guardado al compactar |
Cada memoria lleva una prioridad del 1 al 5: las de prioridad 5 son las normas que Claude ve al empezar cada sesión.
Límites
Busca por palabras, no por significado. «marketing» no encuentra una nota que solo dice «mkt». Por eso cada memoria lleva
keywordscon sinónimos y siglas, que Claude añade al guardar.Avisa, no obliga. Las normas llegan a Claude a tiempo, pero nada le impide ignorarlas.
No se ordena solo. Unificar memorias repetidas y resolver contradicciones lo apruebas tú, con
/episteme:mantencion. Conviene activararchive_expired = true(ver Mantención).El filtro de contraseñas conoce los formatos habituales. Una clave con un formato raro puede pasar: no dictes secretos.
Documentación
El detalle técnico vive en docs/:
Documento | Contenido |
Pasos a mano en Linux, macOS y Windows, y el plugin con las skills | |
Argumentos del servidor, variables, | |
Las 10 herramientas con sus parámetros, el esquema de las memorias y los errores | |
El bloque para | |
Avisos, archivado de memorias vencidas, backup y el ciclo de revisión | |
Cómo traer las memorias de OMEGA | |
Tests, lint, salud del código y scripts de medición | |
Cambios de cada versión |
Desarrollo
uv sync # instala las dependencias
uv run ruff check # lint
uv run pytest # testsEl resto (el lint completo del CI, la revisión de calidad de cada PR con CodeScene y los scripts de medición) está en Desarrollo.
Licencia
MIT, © 2026 Benjamín Criado.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Private memory for AI agents: save and recall facts across Claude Code, Codex, Cursor and ChatGPT.
Persistent cross-session memory shared by Codex, Claude Code, ChatGPT, and other AI agents.
Shared memory for coding agents. Stop re-explaining your codebase every session.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read, write, search, and manage Obsidian vault notes with Git-backed sync support for multi-device access and extensible AI workflows.7,721 npm-
- AlicenseAqualityCmaintenanceEnables coding agents to use an Obsidian vault as long-term memory, with search, reading, and writing of notes, plus automatic capture of learnings that are propagated to MOCs, daily notes, and the knowledge index with git commits.962 npmMIT
- AlicenseAqualityBmaintenanceEnables AI coding agents to store and retrieve durable project decisions, conventions, environment notes, and bug fixes in Notion, with optional Obsidian Vault dual-write.643 npmMIT
- AlicenseBqualityBmaintenanceTurns an Obsidian vault of plain Markdown notes into memory shared by every Claude client, so notes, people, meetings, and follow-ups carry across chats and devices. Provides tools to search, read, capture, write, and link notes, and to track people, organizations, connections, and interactions.17MIT