Skip to content
Help Center

How do I use Evaboot from Codex?

View as Markdown Download .md

Run one command in your terminal to add Evaboot to Codex. Codex reads your Evaboot API key from the EVABOOT_API_KEY environment variable.

Once connected, Codex can build a Sales Navigator search from your description, launch the export, and find or verify emails. It uses the same credits and daily quota as the Evaboot dashboard.

Server URL: https://mcp.evaboot.com/mcp

Before you start

Section titled “Before you start”
  • Codex installed on your computer.
  • An Evaboot account.
  • Your Evaboot API key. Find it on the API key page. The MCP page shows the command with your key already in it.
  • A connected Sales Navigator account for searches and exports. Email finding and email verification work without one.

Treat the key like a password. It gives full access to your Evaboot account. Never commit it to a repository or paste it into a shared document. A new key immediately breaks anything still using the old one.

Steps

Section titled “Steps”

  1. Copy the command from the MCP page, under Codex. Or replace YOUR_API_KEY below with your key: The MCP page of the Evaboot dashboard with the Codex tile selected and its setup steps

    Terminal window
    export EVABOOT_API_KEY="YOUR_API_KEY"
    codex mcp add evaboot --url https://mcp.evaboot.com/mcp \
      --bearer-token-env-var EVABOOT_API_KEY

  2. Run it in your terminal.

  3. Start Codex from a terminal where EVABOOT_API_KEY is set. Codex sends the key from that variable.

Then ask

Section titled “Then ask”

For example: “Using Evaboot, find HR directors at French SaaS companies and export the first 50 with emails”.

If it didn’t work

Section titled “If it didn’t work”
  • The connection fails, or Codex reports a 401. Check that EVABOOT_API_KEY is set in the terminal where you started Codex. Check that the key is the current one.
  • No Evaboot tools appear. Remove the server and add it again.
  • A tool says “insufficient credits” (402). Check your balance in the Evaboot dashboard.
  • A tool returns a 429 error. If the message starts with No connected LinkedIn account, run one extraction from the Evaboot Chrome extension to reconnect your seat. Otherwise you reached the daily export limit of your Sales Navigator seat: wait for the daily reset.
  • Quota shows 0, or a tool returns 409. Evaboot lost your Sales Navigator connection. In Chrome, signed in to the same Evaboot account, open a Sales Navigator search and click Export with Evaboot. Opening the launch page is enough. Then retry. Full steps: How to reconnect your LinkedIn account.
Section titled “Related articles”

Topics