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

Installation

Prerequisites

• Node.js 18 or higher

• An Apollo.io account with API access

• Apollo.io API key (Get yours here)

Setup

1. Clone or download this repository

2. Install dependencies

3. Configure your API key

Create a .env file in the project root:

Edit .env and add your Apollo.io API key:

4. Build the server

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

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:

Example Usage with Claude

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

Finding Prospects

Enriching Data

Managing Sequences

Analyzing Lists

Sales Intelligence

Available Tools

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

"API Key Invalid" Error

• Verify your API key is correct in .env

• Ensure you've enabled API access in your Apollo.io account settings

• Check that your API key has the necessary permissions

"No results found"

• Verify your search criteria aren't too restrictive

• Check that you have credits remaining in your Apollo.io account

• Ensure the data you're searching for exists in Apollo's database

Server not appearing in Claude Desktop

• Verify the path in claude_desktop_config.json is absolute and correct

• Ensure you've run npm run build after making changes

• Restart Claude Desktop after updating the configuration

• Check the logs at ~/Library/Logs/Claude/mcp*.log (macOS)

Development

Watch mode

Testing manually

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