Lusha MCP Server

The Lusha MCP Server connects Lusha's B2B contact and company data directly to your AI workflows. Use it to find, enrich, and prospect through natural language - no manual API calls required.

Every new connection now ships with a built-in starter prompt on the client's consent screen — copy it in one click to run a real first query (find a person, verify they still work there, and pull their title and verified contact details) as soon as you connect. This is available across every MCP client listed below, not just Claude.

Lusha MCP supports two authentication methods. Which one you use depends on your client:

💡 Starter prompt included: every Lusha MCP connection now ships with a ready-to-use starter prompt on the consent screen — copy it in one click to find a person, verify they still work there, and pull their title and verified contact details in a single query. This applies across every MCP client we connect to, not just Claude.

Connect via Lusha's official listing in the Claude connector directory.

1. Go to claude.ai/directory/connectors/lusha
2. Click Add to Claude
3. Complete OAuth authentication
4. Open any chat, click the tools menu, and confirm Lusha tools are listed

Connect via Lusha's official listing in the ChatGPT app directory.

1. Go to chatgpt.com/apps?q=lusha
2. Click Connect
3. Complete OAuth authentication
4. Open any chat, click the tools menu, and confirm Lusha tools are listed

Lusha is available as a full plugin in Codex, with the same data access as the Claude and ChatGPT connectors.

1. Open the plugin directory in Codex and search for Lusha
2. Click Connect and complete OAuth authentication
3. Open any Codex conversation — Lusha tools are available automatically once connected

For clients not listed above, connect using your Lusha API key.

Get your API key: Sign in to Lusha and go to API → Manage API Keys.

MCP Server URL: https://mcp.lusha.com

Requires VS Code 1.99 or higher.

Option A: Settings UI

1. Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Run MCP: Add Server
3. Select HTTP, enter https://mcp.lusha.com, and name it lusha
4. Add x-api-key as the header name and your API key as the value when prompted

Option B: settings.json

{
  "mcp": {
    "servers": {
      "lusha": {
        "type": "http",
        "url": "https://mcp.lusha.com",
        "headers": {
          "x-api-key": "YOUR_LUSHA_API_KEY"
        }
      }
    }
  }
}

To use Lusha tools, open GitHub Copilot Chat, switch to Agent mode, and enable Lusha from the Tools menu.

1. Open (or create) your Cursor MCP config:

   • macOS/Linux: ~/.cursor/mcp.json
   • Windows: %APPDATA%\Cursor\mcp.json

2. Add the following:

{
  "mcpServers": {
    "lusha": {
      "url": "https://mcp.lusha.com",
      "headers": {
        "x-api-key": "YOUR_LUSHA_API_KEY"
      }
    }
  }
}

3. Restart Cursor - Lusha tools will be available automatically in Chat and Composer.

Best for developers using Gemini CLI as their AI-powered terminal who need B2B data for prospecting, enrichment, or research without leaving the command line.

Option A: Extension install (recommended)

gemini extensions install lusha-oss/lusha-gemini-extension

Then set your API key as an environment variable:

export LUSHA_API_KEY=YOUR_LUSHA_API_KEY

Add the export to your shell profile (~/.bashrc, ~/.zshrc, etc.) to persist it across sessions.

Option B: Manual settings.json (Streamable HTTP)

{
  "mcpServers": {
    "lusha": {
      "httpUrl": "https://mcp.lusha.com",
      "headers": {
        "Authorization": "Bearer YOUR_LUSHA_API_KEY"
      }
    }
  }
}

Option C: Manual settings.json (npx/stdio)

{
  "mcpServers": {
    "lusha": {
      "command": "npx",
      "args": ["@lusha-org/mcp@latest"],
      "env": {
        "LUSHA_API_KEY": "YOUR_LUSHA_API_KEY"
      }
    }
  }
}

Using Lusha in Gemini CLI

Once connected, you can ask Lusha questions in natural language directly in your terminal:

• "Find the VP of Engineering at Stripe"
• "Enrich this contact: jane.doe@acme.com"
• "Find 20 Series B SaaS companies in New York hiring in sales"

If you installed via the extension, you also have access to slash commands:

• /lusha:prospect - run a prospecting search
• /lusha:enrich - enrich a contact or company

Requires n8n 1.88.0 or higher.

1. In your workflow, add an MCP Client Tool node
2. Set Connection Type to HTTP Streamable
3. Enter https://mcp.lusha.com as the URL
4. Under Authentication, select Header Auth and set:
   • Header name: x-api-key
   • Value: YOUR_LUSHA_API_KEY
5. Under Tools to Use, select All Tools or choose specific ones
6. Connect the node to your AI Agent node and activate the workflow

Store your API key using n8n's built-in Credentials system rather than pasting it directly into node fields.

Any MCP-compatible client can connect to the Lusha MCP Server using the same pattern:

• URL: https://mcp.lusha.com
• Header: x-api-key: YOUR_LUSHA_API_KEY

Refer to your client's MCP documentation for where to configure the server URL and request headers.

Available tools may vary depending on the client used to connect.

💡 Recommendations tools: results are drawn from the authenticated user's own Target Profiles (plus any shared account-level profiles) — user and account IDs are inferred from the session, never passed as inputs. If you haven't set up a Target Profile in ICP Hub yet, you'll be nudged to do so with each recommendations request. Recommendations refresh daily and recalculate within minutes of an ICP change.

• Store API keys in secure credentials (OS keychain, password manager, or your editor's secrets manager) - avoid hardcoding them in shared config files
• In n8n, use the built-in Credentials system rather than pasting keys directly into node fields
• Use environment variables for team setups instead of committing keys to version control
• Rotate API keys periodically and remove unused connectors
• Limit tool permissions to the minimum needed for your use case