Servidor MCP de memoria persistente para Codex

Memoria local first para Codex mediante un servidor MCP con SQLite, usando recuperacion progresiva con busqueda, timeline y detalles completos bajo demanda.

Harllens George | 2026-02-20

Logo de codex-mem. Wordmark de codex-mem.

codex-mem es un servidor MCP local first, respaldado por SQLite, para flujos de trabajo con OpenAI Codex. Preserva memoria util entre sesiones para que decisiones, restricciones y fixes no se pierdan al reiniciar una sesion.

Que es esto

Es un servidor MCP practico que guarda memoria del proyecto en SQLite local y expone herramientas de recuperacion pensadas para el trabajo diario.

Para quien es

  • Desarrolladores que usan OpenAI Codex en terminal o editor
  • Equipos que prefieren memoria local en lugar de servicios alojados
  • Builders que necesitan handoffs consistentes entre sesiones

Get it

Compatibilidad

  • Clientes y flujos compatibles con MCP (incluyendo setups de Codex con MCP)
  • SQLite local, sin requerir base de datos externa
  • Uso local first con control sobre almacenamiento y retencion

Por que importa

Muchas sesiones de agentes son cortas. Cuando termina la sesion, el contexto del proyecto suele desaparecer. Eso genera explicaciones repetidas, errores repetidos y handoffs lentos.

codex-mem define un contrato simple:

  • Guardar entradas pequenas y de alto valor (decisiones, fixes, restricciones).
  • Recuperar de forma progresiva, no cargando todo de golpe.
  • Mantener los datos en local en una base SQLite bajo tu control.

Que ofrece

Capacidades principales:

  • Almacenamiento SQLite con busqueda full text para recuperacion rapida.
  • Flujo progresivo: buscar, ampliar contexto, y luego traer detalles completos.
  • Ingestion de docs con deduplicacion por hash para re ejecuciones seguras.
  • Reportes de retencion para evitar que la memoria se vuelva ruido.
  • Helpers opcionales para capturar resumenes y commits.

Inicio rapido

Instalacion en un comando

En la raiz del repo:

npm run mcp:install

Setup manual

npm install
export MEMORY_DB_PATH=.memory/codex-mem.db
npm run migrate
npm run mcp:start

Configuracion MCP en VS Code

Valores recomendados:

  • Name: codex-mem
  • Transport: STDIO
  • Command: npm
  • Arguments: run, mcp:start, --silent
  • Environment: MEMORY_DB_PATH=.memory/codex-mem.db
  • Working directory: ruta absoluta al repo codex-mem

Como funciona la recuperacion (progresiva)

Flujo recomendado:

  1. search: descubrimiento rapido.
  2. timeline: ampliar contexto alrededor de un anchor.
  3. get_entries: traer detalles completos solo para IDs seleccionados.

Esto mantiene el costo bajo incluso cuando crece la base de memoria.

Tools MCP (alto nivel)

Tools comunes:

  • save_memory
  • search
  • timeline
  • get_entries
  • ingest_docs
  • retention_dry_run

Automatic mode (opcional)

Un wrapper ligero:

npm run auto:mode -- start --ingest --project codex-mem
npm run auto:mode -- end --summary "Session handoff summary."
npm run auto:mode -- commit

Errores comunes

  • No guardar secrets en la memoria. Los secrets deben ir a un gestor de secretos o env files locales.
  • No guardar dumps largos. Mejor notas cortas y estructuradas con un titulo claro.
  • No ignorar retencion. Ejecuta reportes para mantener la base con alto valor.

Links