Persistent Memory for OpenAI Codex - Unison MCP Setup

Connect OpenAI Codex to Unison via MCP: architecture decisions, team conventions, and open issues survive every context reset automatically.

Learn how to give OpenAI Codex persistent team memory using the Unison MCP server.

Install

codex mcp add unison-brain --env UNISON_TOKEN=usk_live_... -- npx -y @unisonlabs/mcp

Or in ~/.codex/config.toml:

[mcp_servers.unison-brain]
command = "npx"
args = ["-y", "@unisonlabs/mcp"]
env = { UNISON_TOKEN = "usk_live_..." }

Task start: brain_context with the task as the query - relevant decisions, facts, and history arrive as one markdown block.
While working: brain_record_fact when something durable is learned; brain_write for documents worth keeping.
Task end: brain_ingest the conversation so extraction captures what the session produced.

Every other session - yours, your teammates', tomorrow's - recalls what this one learned.

Add the loop to ~/.codex/AGENTS.md so every Codex session runs it unprompted.