Connect Perfect Memory to Codex

This guide connects Perfect Memory to the OpenAI Codex CLI over MCP, so you can ask Codex about your screen history and meetings right from your terminal. It uses the same address as every other client, and you sign in with your Perfect Memory account. New to MCP? Start with how it works.

1. Add Perfect Memory to Codex

Make sure your Codex CLI is up to date, then run:

codex mcp add perfect-memory --url https://proxy.perfectmemory.ai/api/mcp

Codex opens your browser on a Perfect Memory page. Sign in, choose what Codex can read — screen history, meetings, or both — and click Allow. The terminal then says Successfully logged in to MCP server 'perfect-memory'.

Prefer editing config by hand? Add this to ~/.codex/config.toml, then run codex mcp login perfect-memory to sign in:

[mcp_servers.perfect-memory]
url = "https://proxy.perfectmemory.ai/api/mcp"

To confirm it registered, run codex mcp list — the Auth column should say OAuth — or type /mcp inside a Codex session.

2. Turn on the MCP server in the app

On the PC running Perfect Memory, open Settings → Advanced and turn on “Enable MCP server”. On your account page, the status pill turns green (App connected) once the app is online. Searches only work while the app is running.

3. Ask Codex

In a Codex session, try “Search my screen history for the API key I copied earlier” or “What were the action items from my last meeting?” Codex will call Perfect Memory and answer from your own data.

Troubleshooting

• Unknown --url flag — your Codex CLI is too old for remote MCP servers. Update it, or use the config.toml snippet above.
• “App not connected” — make sure Perfect Memory is running with Enable MCP server on; the pill on your account page should be green.
• Asked to sign in again — the connection was disconnected on your account page, or it expired. Run codex mcp login perfect-memory.
• No browser on this machine — run codex mcp login perfect-memory --no-browser, open the link it prints on any device, and paste the address you land on back into the terminal.
• Codex can't see your meetings (or your screen history) — that box was unticked when you connected. Disconnect Codex under Connected apps on your account page, then run codex mcp login perfect-memory and tick both.