Apollo.io MCP Server

A comprehensive Model Context Protocol (MCP) server for Apollo.io API integration. Enables AI assistants to enrich company data, search for people and organizations, manage contacts and accounts, and more.

Features

🔍 Enrichment Tools

• People Enrichment - Enrich person data by name/email/domain
• Organization Enrichment - Get company size, tech stack, department breakdown, funding, revenue

🌐 Global Search Tools

• People Search - Search Apollo's 275M+ person database
• Organization Search - Search Apollo's 70M+ company database

👥 Contact Management (Your Apollo Account)

• Search Contacts - Find contacts you've saved
• Create Contact - Add new contacts
• Update Contact - Modify existing contacts
• View Contact - Get contact details
• Get Person Email - Reveal email addresses

🏢 Account Management (Your Apollo Account)

• Search Accounts - Find accounts (companies) you've saved
• Create Account - Add new accounts (requires master key)
• Update Account - Modify existing accounts
• View Account - Get account details

💼 Other Tools

• Organization Job Postings - Get job listings for a company
• Employees of Company - Find employees by company name/URL

Installation

# Clone or download the repository
cd apollo-mcp-server

# Install dependencies
npm install

# Build the TypeScript
npm run build

Configuration

1. Set up API Keys

Create a .env file in the project root:

APOLLO_API_KEY=your_standard_api_key_here
APOLLO_MASTER_API_KEY=your_master_api_key_here

Get your API keys from Apollo.io Settings → API

2. Configure with OpenCode

Add to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "apollo": {
      "type": "local",
      "command": ["node", "/Users/ognjenbabic/apollo-mcp-server/dist/index.js"],
      "environment": {
        "APOLLO_API_KEY": "your_key_here",
        "APOLLO_MASTER_API_KEY": "your_master_key_here"
      },
      "enabled": true
    }
  }
}

Or use environment variables:

{
  "mcp": {
    "apollo": {
      "type": "local",
      "command": ["node", "/Users/ognjenbabic/apollo-mcp-server/dist/index.js"],
      "environment": {
        "APOLLO_API_KEY": "{env:APOLLO_API_KEY}",
        "APOLLO_MASTER_API_KEY": "{env:APOLLO_MASTER_API_KEY}"
      },
      "enabled": true
    }
  }
}

3. Configure with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apollo": {
      "command": "node",
      "args": ["/Users/ognjenbabic/apollo-mcp-server/dist/index.js"],
      "env": {
        "APOLLO_API_KEY": "your_key_here",
        "APOLLO_MASTER_API_KEY": "your_master_key_here"
      }
    }
  }
}

Usage Examples

With OpenCode

Once configured, you can interact with Apollo through natural language:

"Use apollo to enrich plauti.com - give me company size, tech stack, and department breakdown"

"Search for marketing managers at apollo.io using apollo"

"Find employees of Stripe using apollo"

"Create a contact in apollo for John Doe at example.com"

Direct Tool Usage

Organization Enrichment

{
  "tool": "organization_enrichment",
  "arguments": {
    "domain": "plauti.com"
  }
}

Returns:

• Company size (employee count)
• Tech stack (technologies used)
• Department breakdown
• Industry, revenue, funding
• Location, phone, social profiles

People Search

{
  "tool": "people_search",
  "arguments": {
    "person_titles": ["VP of Marketing", "Marketing Manager"],
    "q_organization_domains_list": ["apollo.io"],
    "per_page": 10
  }
}

Employees of Company

{
  "tool": "employees_of_company",
  "arguments": {
    "company": "Stripe",
    "website_url": "https://stripe.com",
    "person_titles": ["Engineer", "Developer"]
  }
}

Available Tools (15 Total)

Tool	Description	Credit Cost
people_enrichment	Enrich person data	1 credit
organization_enrichment	Enrich company data	1 credit
people_search	Search global people database	Free
organization_search	Search global company database	Free
search_contacts	Search your contacts	Free
create_contact	Add new contact	1 credit
update_contact	Update contact	Free
view_contact	View contact details	Free
search_accounts	Search your accounts	Free
create_account	Add new account	1 credit
update_account	Update account	Free
view_account	View account details	Free
organization_job_postings	Get job postings	Free
get_person_email	Reveal email	1 credit
employees_of_company	Find employees	Free*

*Note: Uses search credits if enriching results

Apollo.io Terminology

• Person - Anyone in Apollo's global database (275M+ people)
• Contact - A person you've explicitly saved to your Apollo account
• Organization - Any company in Apollo's global database (70M+ companies)
• Account - A company you've explicitly saved to your Apollo account

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode (auto-rebuild on changes)
npm run dev

# Start the server
npm start

API Documentation

Full Apollo.io API documentation: https://docs.apollo.io/reference/

Troubleshooting

"APOLLO_API_KEY environment variable is required"

• Ensure .env file exists with your API key
• Or pass via command line: node dist/index.js --api-key=your_key

"Master API key required for account creation"

• Account creation requires a master API key
• Get one from Apollo.io Settings → API → Generate Master Key

Rate Limits

• Apollo uses fixed-window rate limiting
• Check your limits: https://docs.apollo.io/reference/rate-limits
• View usage: https://docs.apollo.io/reference/view-api-usage-stats

License

MIT

Support

For Apollo.io API issues:

• Documentation: https://docs.apollo.io
• Support: https://app.apollo.io/support

For MCP server issues:

• Check the MCP documentation: https://modelcontextprotocol.io
• Review OpenCode docs: https://opencode.ai/docs/mcp-servers