Apollo.io MCP Server

A comprehensive Model Context Protocol (MCP) server that integrates Apollo.io's powerful B2B data and sales engagement platform with Claude AI. This server enables Claude to search for prospects, enrich contact data, manage sequences, analyze lists, and perform all Apollo.io operations through natural conversation.

Features

🔍 Contact & Company Search

• Search People: Find prospects with advanced filters (title, seniority, location, industry, company)
• Search Organizations: Discover companies by size, revenue, location, industry, and technologies
• Email Finder: Find and verify email addresses for prospects
• Data Enrichment: Enrich people and organizations with comprehensive B2B data

📧 Sequence Management

• List Sequences: View all email sequences in your Apollo account
• Get Sequence Details: Detailed information about specific sequences
• Analyze Sequences: Performance metrics including open rates, reply rates, bounce rates
• Add to Sequence: Add contacts to automated email campaigns
• Remove from Sequence: Remove contacts from sequences

📋 List Operations

• Get Lists: Retrieve all contact lists
• Scrape List Contacts: Export all contacts from a list with full details
• Analyze Lists: Detailed breakdown of job titles, seniorities, locations, companies, and data completeness

👤 Contact & Account Management

• Create Contacts: Add new contacts to Apollo
• Update Contacts: Modify contact information
• Create Accounts: Add new companies/accounts
• Get Account Details: Retrieve detailed company information
• Get Person Activity: View engagement history for contacts

💼 Sales Intelligence

• Search Job Postings: Find companies hiring (buying signals)
• Track Activity: Monitor contact engagement and interactions

Quick Start

Automated Setup

Run the verification script to check your setup:

./verify.sh

This will:

• ✓ Verify Node.js version
• ✓ Install dependencies if needed
• ✓ Build the project
• ✓ Show you the exact configuration to use

Manual Installation

Prerequisites

• Node.js 18 or higher
• An Apollo.io account with API access
• Apollo.io API key (Get yours here)

Setup Steps

1. Clone or download this repository

2. Install dependencies

npm install

3. Build the server

npm run build

4. Get your API key
   • Go to https://app.apollo.io/#/settings/integrations/api
   • Copy your API key
   • You'll add it to Claude Desktop config (not a .env file)

Usage

Running with Claude Desktop

Add this to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "apollo": {
      "command": "node",
      "args": ["/absolute/path/to/apollo.io-mcp/build/index.js"],
      "env": {
        "APOLLO_API_KEY": "your_apollo_api_key_here"
      }
    }
  }
}

Replace /absolute/path/to/apollo.io-mcp with the actual path to this project.

Running with Other MCP Clients

The server uses stdio transport and can be run with any MCP-compatible client:

node build/index.js

Example Usage with Claude

Once configured, you can ask Claude to perform Apollo.io operations naturally:

Finding Prospects

"Find CTOs at Series B SaaS companies in San Francisco"

"Search for VP of Sales at companies with 50-200 employees in the fintech industry"

Enriching Data

"Enrich the contact data for john@example.com"

"Get detailed information about apollo.io"

"Find the email address for John Smith at Apollo.io"

Managing Sequences

"Show me all my email sequences"

"Analyze the performance of sequence ID abc123"

"Add these contact IDs to my outbound sequence: [id1, id2, id3]"

Analyzing Lists

"Analyze my Enterprise Leads list"

"Show me all contacts in list ID xyz789"

"What's the breakdown of job titles in my Q4 Prospects list?"

Sales Intelligence

"Find companies hiring for Sales Director positions"

"Show me the activity history for contact ID abc123"

Available Tools

Tool	Description
search_people	Search for contacts with advanced filters
search_organizations	Search for companies by various criteria
enrich_person	Enrich contact data with email, phone, socials
enrich_organization	Get detailed company information
find_email	Find and verify email addresses
list_sequences	List all email sequences
get_sequence	Get sequence details and steps
analyze_sequence	Analyze sequence performance metrics
add_to_sequence	Add contacts to a sequence
remove_from_sequence	Remove contacts from a sequence
get_lists	Get all contact lists
get_list_contacts	Scrape/export contacts from a list
analyze_list	Detailed list analytics and breakdown
create_contact	Create new contact
update_contact	Update contact information
create_account	Create new account/company
get_account	Get account details
search_job_postings	Search job postings for buying signals
get_person_activity	Get contact activity history

API Rate Limits

Apollo.io enforces rate limits based on your plan:

• Free Plan: 50 credits/month
• Basic Plan: 1,200 credits/month
• Professional Plan: 12,000 credits/month
• Organization Plan: Custom limits

Each API call consumes credits. Monitor your usage in the Apollo.io dashboard.

Troubleshooting

Quick Checks

1. Run the verification script:

   ./verify.sh
   

2. Common issues:

   • ✗ Using relative path instead of absolute path
   • ✗ API key not set in config
   • ✗ Forgot to restart Claude Desktop
   • ✗ Config JSON has syntax errors
   • ✗ Wrong config file location

Detailed Troubleshooting

See TROUBLESHOOTING.md for comprehensive solutions to:

• Server not appearing in Claude Desktop
• API key errors
• Module not found errors
• Network/API issues
• Build failures
• Log checking and debug mode

Quick Fix

If nothing works, try a complete reset:

cd /path/to/apollo.io-mcp
rm -rf node_modules build package-lock.json
npm install
npm run build
chmod +x build/index.js
# Then restart Claude Desktop

Development

Watch mode

npm run watch

Testing manually

npm run dev

Resources

• Apollo.io API Documentation
• Model Context Protocol Documentation
• Apollo.io API Key Management

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues related to:

• This MCP Server: Open an issue in this repository
• Apollo.io API: Contact Apollo.io Support
• MCP Protocol: Visit MCP Documentation

---

Built with ❤️ using the Model Context Protocol