Skip to content
OpenAI

Connect Codex to Relay

Give Codex a memory it shares with your other AIs. Plans, progress and reviews saved in Codex can be picked up by any of the 25 AI tools Relay works with, and the other way round. It takes about two minutes.

What you need
Codex CLI or IDE extension
How it connects
One command or config entry (MCP)

1. Get your connection link

  1. Sign in to Relay with Google. It's free during the beta.
  2. Open Integrations, click Set up on Codex, then Generate connection URL. Copy it straight away: it's shown only once.
  3. Below, YOUR-KEY stands for your link. The dashboard shows the same steps with your link already filled in.

2. Add Relay to Codex

  1. In a terminal, register the server once:
    codex mcp add relay --url https://mcp.relaymemory.app/mcp/YOUR-KEY
  2. Start codex and run /mcp. relay should be listed. (It's saved in ~/.codex/config.toml.)

3. Test it

Send this in Codex. It should answer from your Relay memory:

Pick up what's waiting for me in Relay.

Make it save on its own

  1. In a Codex session, send this once:
    In every conversation, store our work in Relay: save new plans, add progress updates as we go, and keep it up to date.
  2. Codex asks permission to use Relay. Choose Allow always, so it saves as you work. Deleting always asks you first.
  3. To keep it on in new sessions, add the same sentence to your project's AGENTS.md.

Using Relay in Codex every day

  • Relay loads in every Codex session. Check it with /mcp.
  • Codex asks before running tools, depending on its approval mode (/approvals). Approve Relay's tools when asked.
  • Make it automatic: add this line to your project's AGENTS.md, and it checks Relay on its own.
    At the start of a task, check Relay for the latest plan for this project. When you finish, add a progress update to Relay.

Things to say in Codex:

Save this plan to Relay for the project "My project".
Pick up my latest plan from Relay and continue it.
Add a progress update to Relay for this work.
Review the latest work in Relay and add your review.
Remember in Relay that I prefer short answers.
What's waiting for me in Relay?
Codex uses Relay's cloud endpoint, so it works even when Relay isn't running on your PC.

Connect Codex in two minutes

Sign in with Google, connect your first AI and save your first handoff in a few minutes.

Join the free beta