mcp-apollo

An open-source, self-hosted MCP server for Apollo.io — gives your AI agents direct access to Apollo's B2B sales intelligence database.

Deploy it to your own Cloudflare account in under 5 minutes. You own the infrastructure, you control the costs. No shared hosting, no vendor lock-in.

Built and maintained by AgenTeam. MIT licensed.

How it works

Your Cloudflare Workers account
  └── mcp-apollo Worker  (your deploy, your infra)
        └── MCP client sends requests with your Apollo API key
              └── Worker proxies to Apollo.io API
                    └── Returns enriched data to your agent

• You deploy the Worker to your own Cloudflare account (free tier handles most use cases)
• You pass your own Apollo.io API key on every request — the Worker never stores it
• No shared infrastructure — every user runs their own isolated instance

Quick deploy (5 minutes)

Prerequisites

• Node.js 18+
• A Cloudflare account (free tier is sufficient)
• An Apollo.io API key

Steps

# 1. Clone the repo
git clone https://github.com/AgenTeam-AI-2026/mcp-apollo
cd mcp-apollo

# 2. Install dependencies
npm install

# 3. Log in to your Cloudflare account
npx wrangler login

# 4. Deploy
npx wrangler deploy

Your server is now live at:

https://mcp-apollo.<your-subdomain>.workers.dev

That's your personal MCP server URL. Use it in the connection configs below.

Connect your MCP client

Replace YOUR_WORKER_URL with your deployed URL and YOUR_APOLLO_KEY with your Apollo.io API key.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "apollo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR_WORKER_URL/mcp"],
      "env": {
        "APOLLO_API_KEY": "YOUR_APOLLO_KEY"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

claude mcp add apollo \
  --transport http \
  --url https://YOUR_WORKER_URL/mcp \
  --header "Authorization: Bearer YOUR_APOLLO_KEY"

Cursor

In .cursor/mcp.json:

{
  "mcpServers": {
    "apollo": {
      "url": "https://YOUR_WORKER_URL/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APOLLO_KEY"
      }
    }
  }
}

Windsurf

In ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "apollo": {
      "serverUrl": "https://YOUR_WORKER_URL/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APOLLO_KEY"
      }
    }
  }
}

Get an Apollo.io API key

1. Log in to apollo.io
2. Go to Settings → Integrations → API
3. Click Create API Key
4. Copy the key — paste it into your MCP client config above

Tools

apollo_search_people

Search Apollo's database for people matching filters.

| Parameter | Type | Description | |---|---|---| | person_titles | string[] | Job titles, e.g. ["VP Engineering", "CTO"] | | person_seniorities | string[] | "vp", "c_suite", "director", "manager", "senior" | | organization_domains | string[] | Company domains, e.g. ["stripe.com"] | | person_locations | string[] | Locations, e.g. ["New York", "San Francisco"] | | organization_num_employees_ranges | string[] | Size ranges, e.g. ["51,200", "201,500"] | | page | number | Page number (default: 1) | | per_page | number | Results per page, max 25 (default: 10) |

apollo_enrich_person

Get a full enriched profile for a specific person.

| Parameter | Type | Description | |---|---|---| | email | string | Most reliable identifier | | linkedin_url | string | LinkedIn profile URL | | first_name + last_name + organization_name | string | Name + company combo

... View full README on GitHub