Connect Codex
Use Rampsend from Codex CLI, the ChatGPT desktop app and the Codex IDE extension
The Codex CLI, the ChatGPT desktop app and the Codex IDE extension read the same MCP configuration, so one setup covers all three. Add the Rampsend endpoint and the agent can send email and check deliveries without leaving your editor.
Run in your terminal
codex mcp add rampsend --url https://app.rampsend.com/api/mcpSet it up
- 1
Add the server
--url selects the Streamable HTTP transport.
Terminal codex mcp add rampsend --url https://app.rampsend.com/api/mcp - 2
Sign in
Runs the OAuth flow in your browser and stores the credentials for you.
Terminal codex mcp login rampsend - 3
Or use an API key
Skip the sign-in: set bearer_token_env_var as in the config below and export the variable in the shell you start Codex from.
- 4
Check it
codex mcp list shows the configured servers; /mcp inside the Codex TUI shows what is actually live.
Terminal codex mcp list - 5
Desktop app and IDE extension
Both read the same file. In the ChatGPT desktop app: Settings → MCP servers → Add server, choose Streamable HTTP, paste the endpoint, then Restart. In the Codex IDE extension it is the gear menu → MCP servers.
The config
File: ~/.codex/config.toml
# Option A - sign in (run: codex mcp login rampsend)[mcp_servers.rampsend]url = "https://app.rampsend.com/api/mcp"auth = "oauth"# Option B - API key instead# [mcp_servers.rampsend]# url = "https://app.rampsend.com/api/mcp"# bearer_token_env_var = "RAMPSEND_API_KEY"Shared by the CLI, the ChatGPT desktop app and the Codex IDE extension. A project .codex/config.toml works too, in trusted projects.
Check it works
Ask “How many Rampsend credits do I have left?”. A number back means you are connected. That call only reads your account, so testing costs nothing.
What trips people up
- If bearer_token_env_var names a variable that is not exported, Codex connects without a credential instead of erroring, and every tool call comes back asking for sign-in.
- Adding the server in the ChatGPT desktop app does not add it on chatgpt.com, and the other way round. For the web, follow the ChatGPT guide.
- The desktop and IDE screens only take a name, transport and URL. Keys and headers go in config.toml.
- Restart the app or the extension after changing a server. It does not reload on its own.
- “missing field command in mcp_servers” means an old Codex build. Update it; current builds handle HTTP servers directly.
Try asking
- “Send a test of the template in emails/welcome.html to me@acme.com.”
- “Find the emails sent to ada@example.com this week and tell me their status.”
- “What’s my bounce rate over the last 7 days?”
- “How many Rampsend credits do I have left?”