Codex

OpenAI Codex supports MCP servers.

Quick setup

memax setup --only codex --mcp

Codex's config is TOML, not JSON, at ~/.codex/config.toml:

[mcp_servers.memax]
command = "npx"
args = ["-y", "memax-cli", "mcp", "serve", "--agent", "codex"]

For remote MCP (hosted), use a url block and put the auth header under a nested [mcp_servers.memax.headers] table:

[mcp_servers.memax]
type = "url"
url = "https://api.memax.app/mcp"

[mcp_servers.memax.headers]
Authorization = "Bearer mxk_..."

memax login

(Skip if using remote MCP with an mxk_ token.)

Start a Codex session and ask which tools it has. You should see the 9 Memax tools listed in memax mcp.

Codex can use Memax to:

Pull project conventions, architecture decisions, and context before generating code (memax_recall).
Store decisions and learnings made during a session (memax_push, memax_capture).
Browse hub / topic structure (memax_hubs, memax_topics).

CONTEXT=$(memax recall "deployment checklist" --format text)
# Include in your Codex prompt manually.