Apollo MCP Server

A Model Context Protocol (MCP) server for Apollo.io - the leading sales intelligence and engagement platform. This server provides 34+ tools for automating sales outreach, prospecting, and pipeline management.

Features

• People Search & Enrichment - Find and enrich contact data from Apollo's 275M+ contact database
• Organization Search & Enrichment - Search companies by industry, size, location, and more
• Email Sequences - Create and manage automated outreach campaigns with A/B testing
• Contact Management - Organize contacts into lists and manage pipeline stages
• Workflow Automation - Build event-driven automations for your sales process
• Tasks & Activities - Create and track sales activities
• Deals Pipeline - Manage opportunities through your sales pipeline
• Analytics - Track sequence performance and email deliverability

Installation

Prerequisites

• Python 3.10+
• An Apollo.io account with API access
• uv (recommended) or pip

Install with uv

# Clone the repository
git clone https://github.com/BlockchainRev/apollo-mcp-server.git
cd apollo-mcp-server

# Install dependencies
uv pip install -e .

Install with pip

pip install -e .

Configuration

Get Your Apollo API Key

1. Log in to Apollo.io
2. Go to Settings > Integrations > API
3. Generate or copy your API key

Set Environment Variable

export APOLLO_API_KEY="your-api-key-here"

Or add to your shell profile (~/.bashrc, ~/.zshrc, etc.):

echo 'export APOLLO_API_KEY="your-api-key-here"' >> ~/.zshrc

Usage

With Claude Code

Add to your Claude Code MCP configuration (~/.claude.json):

{
  "mcpServers": {
    "apollo": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/apollo-mcp-server", "python", "-m", "apollo_mcp.server"],
      "env": {
        "APOLLO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Standalone

# Run the server
python -m apollo_mcp.server

Available Tools

People & Contacts (6 tools)

Organizations (3 tools)

Email Sequences (5 tools)

Contact Lists (3 tools)

Workflows (7 tools)

Email (2 tools)

Tasks (2 tools)

Deals (2 tools)

Analytics (2 tools)

Utility (4 tools)

Examples

Search for Decision Makers

# Find VPs of Sales at tech companies in California
people_search(
    person_titles=["VP Sales", "Vice President of Sales"],
    organization_locations=["California, US"],
    organization_num_employees_ranges=["51,200", "201,500"]
)

Create an Outreach Sequence

sequence_create(
    name="New Lead Outreach",
    steps=[
        {
            "type": "auto_email",
            "wait_time": 0,
            "wait_mode": "minute",
            "emailer_touches": [{
                "type": "new_thread",
                "subject": "Quick question about {{company}}",
                "body_html": "<p>Hi {{first_name}},</p><p>I noticed {{company}} is growing...</p>"
            }]
        },
        {
            "type": "auto_email",
            "wait_time": 3,
            "wait_mode": "day",
            "emailer_touches": [{
                "type": "reply",
                "subject": "Re: Quick question about {{company}}",
                "body_html": "<p>Following up on my last email...</p>"
            }]
        }
    ]
)

Create a Workflow Automation

workflow_create(
    name="New Contact Nurture",
    trigger_type="event",
    trigger_events=["contact_saved_or_created"],
    actions=[
        {"type": "add_to_sequence", "config": {"sequence_id": "abc123"}}
    ]
)

Email Personalization Variables

Use these variables in email templates:

API Endpoints

The server uses two Apollo API endpoints:

• Public API (api.apollo.io/v1/): People search, enrichment
• App API (app.apollo.io/api/v1/): Sequences, workflows, lists, etc.

All requests use the X-Api-Key header for authentication.

Development

Project Structure

apollo-mcp-server/
├── apollo_mcp/
│   ├── __init__.py          # Package initialization
│   ├── server.py             # Main MCP server
│   ├── client.py             # HTTP client for Apollo API
│   ├── utils/
│   │   ├── __init__.py
│   │   ├── config.py         # Configuration and settings
│   │   └── formatting.py     # Output formatting utilities
│   └── tools/
│       ├── __init__.py       # Tool registration
│       ├── people.py         # People/contact tools
│       ├── organizations.py  # Organization tools
│       ├── sequences.py      # Email sequence tools
│       ├── lists.py          # List management tools
│       ├── workflows.py      # Workflow automation tools
│       ├── email.py          # Email tools
│       ├── tasks.py          # Task management tools
│       ├── deals.py          # Deal/opportunity tools
│       ├── analytics.py      # Analytics tools
│       └── utility.py        # Helper tools
├── examples/
│   └── basic_usage.py        # Usage examples
├── pyproject.toml            # Project configuration
├── requirements.txt          # Dependencies
└── README.md

Running Tests

# Install dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

MIT License - see LICENSE for details.

Acknowledgments

• Apollo.io for the sales intelligence platform
• Anthropic for the Model Context Protocol
• FastMCP for the MCP Python framework