Skip to main content
Codex MCP install docs You can find your Ref API key at ref.tools/keys

​
Install

Codex is configured in a config.toml file. This typically lives at ~/.codex/config.toml To enable Ref Plans, update your config.toml to include: 
[mcp_servers.ref-plan]
url = "https://api.plan.ref.tools/mcp?apiKey=<your-api-key>"
For plan-specific mode: 
[mcp_servers.ref-plan]
url = "https://api.plan.ref.tools/mcp?plan=<PLAN_ID>&apiKey=<your-api-key>"

​
Verify

Run the command: 
codex mcp list
You should see ref-plan listed with the Ref Plans MCP URL.

​
Get help

If you have any issues, please reach out to help@ref.tools. We’re happy to help you get started!