AI assistants · CLI and IDE

Codex

Add Rolodexy to OpenAI's Codex CLI and IDE extension.

MCP server
https://mcp.rolodexy.ai

What you need

  • The Codex CLI or IDE extension.
  • A Rolodexy API key.

Set it up

  1. Create an API key

    In Rolodexy, open Settings → API keys and create a key for this assistant. Copy it; it is shown once.

  2. Put the key in an environment variable

    Codex sends it as a Bearer token. Add this to your shell profile so it is always set.

    Shell profile
    export ROLODEXY_API_KEY="rdx_your_key"
  3. Add the server

    Terminal
    codex mcp add rolodexy --url https://mcp.rolodexy.ai \
      --bearer-token-env-var ROLODEXY_API_KEY

    Or add it to ~/.codex/config.toml by hand. The CLI and the IDE extension share this file.

    ~/.codex/config.toml
    [mcp_servers.rolodexy]
    url = "https://mcp.rolodexy.ai"
    bearer_token_env_var = "ROLODEXY_API_KEY"
  4. Check the connection

    Run codex mcp list, or type /mcp inside Codex to see Rolodexy's tools.

Try a first prompt

“Using Rolodexy, find 10 heads of sales at software companies in Germany with 51 to 200 people. Show me the list before revealing anyone.”

Searching is free. Revealing a contact spends credits, so asking to see the list first keeps you in control. See Tools and pricing.

Troubleshooting

401 even though the key is right
The variable is not set where Codex runs. Open a new terminal, or set it in the environment the IDE starts from.
401 unauthorized
The key is missing, mistyped or revoked. Check there are no spaces or quotes around it, or create a new one.
402 insufficient_credits
The workspace is out of credits. Searching still works; top up on the Billing page to reveal more.