Apollo.io MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with the Apollo.io API. This server enables AI assistants to search for accounts, enrich people and organization data, and retrieve contact information.
Features
Account Management
Search Accounts: Find companies by name, location, employee count, and industry
Get Account Details: Retrieve comprehensive account information by ID
Create Accounts: Add new accounts to your Apollo.io database
Update Accounts: Modify existing account information
People & Contact Data
Search People: Find contacts by job title, seniority, company, and location
Enrich Person: Get detailed contact information including emails and phone numbers
Bulk Enrichment: Enrich multiple people or organizations simultaneously
Organization Data
Enrich Organizations: Get detailed company information from domain
Bulk Organization Enrichment: Enrich up to 10 companies at once
Technology Stack: See what technologies companies use
Financial Data: Access funding information and revenue data
Additional Features
Persona Information: Access created persona data and counts
Intent Data: Integration ready for Bombora intent data
Email Accounts: Manage email accounts for sequences
Opportunities: Search and manage sales opportunities
Health Checks: Verify API connectivity and authentication
Prerequisites
Python 3.8 or higher
UV package manager
Apollo.io API key
Installation
Clone or create the project:
mkdir apollo-mcp-server cd apollo-mcp-serverInstall UV (if not already installed):
curl -LsSf https://astral.sh/uv/install.sh | shInstall dependencies:
uv syncSet up environment variables:
cp .env.example .env # Edit .env and add your Apollo.io API key
Configuration
Apollo.io API Key
Log in to your Apollo.io account
Go to Settings → Integrations → API
Generate or copy your API key
Add it to your
.env
file:APOLLO_API_KEY=your_actual_api_key_here
Usage
Running the Server
Or using the installed script:
Available Tools
Account Search
People Search
Person Enrichment
Organization Enrichment
Bulk Organization Enrichment
API Endpoints Covered
/v1/accounts/search
- Account search/v1/accounts/{id}
- Get account by ID/v1/accounts
- Create/update accounts/v1/mixed_people/search
- People search/v1/people/match
- Person enrichment/api/v1/people/bulk_match
- Bulk people enrichment/v1/organizations/enrich
- Organization enrichment/api/v1/organizations/bulk_enrich
- Bulk organization enrichment/v1/opportunities/search
- Opportunities search/v1/email_accounts
- Email accounts/v1/auth/health
- Health check
Error Handling
The server includes comprehensive error handling for:
Invalid API keys
Rate limiting
Network errors
Invalid request parameters
API response errors
All errors are returned in a structured format with descriptive messages.
Rate Limiting
Apollo.io has different rate limits for different endpoints:
Single enrichment endpoints: Standard rate limits
Bulk enrichment endpoints: 1/10th of standard rate limits
Search endpoints: Higher rate limits for pagination
The server respects these limits and will return appropriate error messages if limits are exceeded.
Credit Usage
Different Apollo.io operations consume different types of credits:
Email Credits: 1 credit per verified email found
Export Credits: 1 credit per non-empty record (newer plans)
Phone Credits: Additional charges for phone number reveals
Development
Running Tests
Code Formatting
Type Checking
Integration with AI Assistants
This MCP server can be used with AI assistants that support the Model Context Protocol, such as:
Claude Desktop
Cody
Continue
Any MCP-compatible tool
Configure your AI assistant to connect to this server to enable Apollo.io functionality.
Persona and Intent Data
Persona Information
The server provides access to persona counts and created persona information through the account and organization endpoints. Persona data helps understand the types of contacts and their roles within organizations.
Intent Data Integration
While Apollo.io doesn't directly provide Bombora intent data through their standard API, the server is structured to easily integrate intent data when available. This typically requires:
Separate Bombora API integration
Data correlation between Apollo.io contacts and Bombora intent signals
Custom enrichment workflows
Contact Apollo.io support for information about intent data partnerships and availability.
Support
For issues with this MCP server:
Check the error messages and logs
Verify your API key is valid
Ensure you have sufficient API credits
Check Apollo.io API documentation for any changes
For Apollo.io API issues:
Visit Apollo.io support documentation
Contact Apollo.io customer support
Check API status page
License
MIT License - see LICENSE file for details.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Enables AI assistants to interact with Apollo.io API for sales and marketing activities. Provides tools to search for companies and contacts, enrich person and organization data, and manage accounts with comprehensive lead generation capabilities.