How do I use Apollo MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Apollo MCP Server find marketing directors at SaaS companies in New York" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Log in to Apollo.io
Go to Settings > Integrations > API
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)

Tool	Description
`people_search`	Search Apollo's 275M+ contact database with filters
`people_enrich`	Enrich a person's profile by email, name, or LinkedIn
`contacts_search`	Search contacts in your Apollo CRM

Organizations (3 tools)

Tool	Description
`organization_search`	Search companies by industry, size, location
`organization_enrich`	Get comprehensive company data by domain
`organization_job_postings`	Get current job postings for a company

Email Sequences (5 tools)

Tool	Description
`sequences_list`	List all email sequences
`sequence_get`	Get sequence details and stats
`sequence_create`	Create multi-step outreach sequences
`sequence_add_contacts`	Add contacts to a sequence
`sequence_activate`	Activate or pause a sequence

Contact Lists (3 tools)

Tool	Description
`lists_get`	Get all saved lists
`list_create`	Create a new contact list
`list_add_contacts`	Add contacts to a list

Workflows (7 tools)

Tool	Description
`workflows_list`	List all workflow automations
`workflow_get`	Get workflow details
`workflow_create`	Create event-driven automations
`workflow_update`	Update workflow configuration
`workflow_activate`	Activate or deactivate workflows
`workflow_delete`	Delete a workflow
`workflow_templates_list`	Browse workflow templates
`workflow_create_from_template`	Create from a template

Email (2 tools)

Tool	Description
`email_preview`	Preview emails with variable substitution
`email_send`	Send one-off emails

Tasks (2 tools)

Tool	Description
`tasks_list`	List all tasks
`task_create`	Create tasks for contacts

Deals (2 tools)

Tool	Description
`deals_list`	List pipeline opportunities
`deal_create`	Create new deals

Analytics (2 tools)

Tool	Description
`analytics_sequences`	Get sequence performance metrics
`analytics_email_accounts`	Get email deliverability stats

Utility (4 tools)

Tool	Description
`get_available_fields`	List email personalization variables
`get_email_schedules`	Get sending schedule options
`get_contact_stages`	Get contact pipeline stages
`get_account_stages`	Get account pipeline stages

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:

Variable	Description
`{{first_name}}`	Contact's first name
`{{last_name}}`	Contact's last name
`{{company}}`	Company name
`{{title}}`	Job title
`{{email}}`	Email address
`{{city}}`	City
`{{state}}`	State/region
`{{country}}`	Country

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:

Fork the repository
Create a feature branch
Make your changes
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