Skip to content

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

Terminal
codex mcp add rampsend --url https://app.rampsend.com/api/mcp

Set it up

  1. 1

    Add the server

    --url selects the Streamable HTTP transport.

    Terminal
    codex mcp add rampsend --url https://app.rampsend.com/api/mcp
  2. 2

    Sign in

    Runs the OAuth flow in your browser and stores the credentials for you.

    Terminal
    codex mcp login rampsend
  3. 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. 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. 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

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?”

Using something else?