Codex CLI (OpenAI)

Codex CLI is OpenAI's coding agent that runs locally. It supports MCP servers as extensions.

Setup

# Install Codex CLI
npm i -g @openai/codex

# Add engram as MCP server
codex mcp add engram \
  --env GEMINI_API_KEY="your-key" \
  -- engram-mcp

# Verify
codex mcp list

This creates an entry in ~/.codex/config.toml:

[mcp_servers.engram]
command = "engram-mcp"

[mcp_servers.engram.env]
GEMINI_API_KEY = "your-key"

Usage

Once configured, Codex can use engram's 21 MCP tools during sessions. Start a session:

codex "recall what we discussed about deployment"

Codex will automatically discover and use engram tools like engram_recall, engram_remember, and engram_think when relevant to your queries.

Available Tools

All 21 engram MCP tools are available. See MCP Tools Reference for the full list.

Troubleshooting

MCP server not connecting:

# Check MCP server status
codex mcp list

# Test engram-mcp directly
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | engram-mcp

# Remove and re-add
codex mcp remove engram
codex mcp add engram --env GEMINI_API_KEY="your-key" -- engram-mcp