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:

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

3. Build the server

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

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

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:

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