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
-
Clone or download this repository
-
Install dependencies
npm install
- Build the server
npm run build
- 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
-
Run the verification script:
./verify.sh -
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
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