AI assistants · Desktop app

Claude

Use Rolodexy in the Claude desktop app through a small local bridge.

MCP server
https://mcp.rolodexy.ai

What you need

  • The Claude desktop app for macOS or Windows.
  • Node.js 18 or later, for npx.
  • 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. Open the config file

    In Claude, open Settings → Developer → Edit Config. That opens claude_desktop_config.json: on macOS in ~/Library/Application Support/Claude/, on Windows in %APPDATA%\Claude\.

  3. Add Rolodexy

    Add this entry. mcp-remote runs on your computer and forwards Claude's requests to Rolodexy with your key.

    claude_desktop_config.json
    {
      "mcpServers": {
        "rolodexy": {
          "command": "npx",
          "args": [
            "-y", "mcp-remote", "https://mcp.rolodexy.ai",
            "--header", "X-API-Key:${ROLODEXY_API_KEY}"
          ],
          "env": { "ROLODEXY_API_KEY": "rdx_your_key" }
        }
      }
    }

    Keep X-API-Key: and the key together with no space; some systems split arguments at spaces.

  4. Restart Claude

    Quit Claude fully and open it again. Rolodexy appears under the tools button in a new chat.

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

Can I add Rolodexy as a custom connector on claude.ai?
Not yet. Custom connectors on claude.ai and in the desktop app's Connectors screen sign in with OAuth, which Rolodexy does not offer yet. The config file route above works today.
Rolodexy does not appear after restarting
Check the file is valid JSON, and that npx --version works in a terminal. Claude's logs are under Settings → Developer.
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.