AI assistants · Terminal

Gemini CLI

Add Rolodexy to Google's Gemini CLI.

MCP server
https://mcp.rolodexy.ai

What you need

  • Gemini CLI installed.
  • 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. Add the server

    Edit ~/.gemini/settings.json, or .gemini/settings.json in a project.

    settings.json
    {
      "mcpServers": {
        "rolodexy": {
          "httpUrl": "https://mcp.rolodexy.ai",
          "headers": { "X-API-Key": "rdx_your_key" }
        }
      }
    }

    Gemini CLI expands environment variables, so "X-API-Key": "$ROLODEXY_API_KEY" also works.

  3. Check the connection

    Start gemini and type /mcp. Rolodexy should be listed as ready with its 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

Rolodexy is listed as disconnected
Use httpUrl, not url: url is for older SSE servers.
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.