Persistenter Memory MCP Server fuer Codex

Local first Codex Memory ueber einen MCP Server mit SQLite, inklusive progressiver Retrieval Tools fuer Suche, Timeline Kontext und komplette Entry Details.

Harllens George | 2026-02-20

codex-mem Logo. codex-mem Wordmark.

codex-mem ist ein local first, SQLite basierter MCP Server fuer OpenAI Codex Workflows. Er bewahrt hilfreiche Projekt Memory ueber Codex Sessions hinweg, damit Kontext, Entscheidungen und Constraints nicht bei jedem Lauf verloren gehen.

Was das ist

Ein pragmatischer MCP Server, der Projekt Memory lokal in SQLite speichert und Retrieval Tools fuer den Entwickleralltag bereitstellt.

Fuer wen es gedacht ist

  • Entwickler mit OpenAI Codex im Terminal oder Editor Workflow
  • Teams, die lokale Memory statt gehosteter Dienste bevorzugen
  • Builder, die reproduzierbare Session Handoffs brauchen

Get it

Kompatibilitaet

  • MCP kompatible Clients und Workflows (inklusive Codex Setups mit MCP)
  • SQLite als lokaler Storage, keine externe Datenbank notwendig
  • Local first Nutzung mit Kontrolle ueber Storage und Retention

Warum das wichtig ist

Agent Sessions sind oft kurzlebig. Wenn die Session endet, ist der Projekt Kontext meist weg. Das fuehrt zu Wiederholungen, inkonsistenten Entscheidungen und langsamen Handoffs.

codex-mem setzt einen einfachen Rahmen:

  • Kleine, hoch relevante Memory Entries speichern (Entscheidungen, Fixes, Constraints).
  • Progressiv abrufen, statt alles gleichzeitig zu laden.
  • Daten lokal in einer SQLite DB, die komplett unter eigener Kontrolle bleibt.

Was man bekommt

Kernfunktionen:

  • SQLite Storage mit Full Text Search fuer schnelle Abfragen.
  • Progressive Discovery: Search, Kontext erweitern, dann Details abrufen.
  • Doc Ingestion mit Source Hash Dedupe fuer sichere Re Runs.
  • Retention Reporting, damit Memory nicht zu Rauschen wird.
  • Optionale Workflow Helfer fuer Summary und Commit Capture.

Quick start

One command install

Im Repo Root:

npm run mcp:install

Manuelles Setup

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

VS Code MCP Settings

Diese Werte entsprechen den Default Einstellungen:

  • Name: codex-mem
  • Transport: STDIO
  • Command: npm
  • Arguments: run, mcp:start, --silent
  • Environment: MEMORY_DB_PATH=.memory/codex-mem.db
  • Working directory: absoluter Pfad zum codex-mem Repo

Wie Retrieval funktioniert (progressiv)

Empfohlener Ablauf:

  1. search: schnelle Discovery.
  2. timeline: Kontext um einen Anchor Entry erweitern.
  3. get_entries: komplette Details nur fuer selektierte IDs abrufen.

Das bleibt performant, auch wenn die Memory DB groesser wird.

MCP Tools (high level)

Hauefige Tools:

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

Automatic mode (optional)

Optionaler Workflow Wrapper:

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

Typische Fehler vermeiden

  • Keine Secrets in Memory speichern. Secrets gehoeren in Secret Manager oder lokale env Files.
  • Keine langen Dumps speichern. Lieber kurze, strukturierte Notes mit klarer Ueberschrift.
  • Retention nicht vergessen, damit die DB langfristig high signal bleibt.

Links