Apollo.io MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apollo.io MCP Server find companies in San Francisco with 50-200 employees in the tech industry"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: Apollo MCP Server
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
.envfile:APOLLO_API_KEY=your_actual_api_key_here
Usage
Running the Server
uv run python src/apollo_mcp_server.pyOr using the installed script:
uv run apollo-mcp-serverAvailable Tools
Account Search
search_accounts({
"q_organization_name": "Google",
"organization_locations": ["California, US"],
"organization_num_employees_ranges": ["1000,10000"],
"page": 1,
"per_page": 25
})People Search
search_people({
"q_organization_domains": "apollo.io\ngoogle.com",
"person_titles": ["CEO", "CTO", "VP Engineering"],
"person_seniorities": ["senior", "manager"],
"organization_locations": ["California, US"],
"page": 1,
"per_page": 10
})Person Enrichment
enrich_person({
"first_name": "Tim",
"last_name": "Zheng",
"email": "tim@apollo.io",
"organization_name": "Apollo",
"domain": "apollo.io",
"linkedin_url": "http://www.linkedin.com/in/tim-zheng-677ba010",
"reveal_personal_emails": true,
"reveal_phone_number": false
})Organization Enrichment
enrich_organization({
"domain": "apollo.io"
})Bulk Organization Enrichment
bulk_enrich_organizations([
"apollo.io",
"google.com",
"microsoft.com"
])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
uv run pytestCode Formatting
uv run black src/
uv run isort src/Type Checking
uv run mypy src/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.
Available Tools
11 toolsbulk_enrich_organizationsB
Bulk enrich multiple organizations at once.
This tool enriches multiple companies simultaneously based on their domains. Up to 10 domains can be processed in a single request.
Inputs: domains (required). Returns: object
create_accountC
Create a new account in Apollo.io.
This tool creates a new account with the provided information. The domain and address will be intelligently parsed for additional data.
Inputs: name (required), domain, phone_number, raw_address. Returns: object
enrich_organizationC
Enrich organization/company information.
This tool enriches company data based on domain, returning detailed information about the organization including industry, employee count, contact info, and more.
Inputs: request (required). Returns: object
enrich_personC
Enrich a person's information and reveal contact details.
This tool enriches person data and can reveal email addresses and phone numbers. The more information provided, the higher the match likelihood.
Inputs: request (required). Returns: object
get_account_by_idA
Retrieve detailed information for a specific account by ID.
This tool fetches comprehensive account data including contact information, custom fields, and associated personas.
Inputs: account_id (required). Returns: object
get_email_accountsB
Retrieve email accounts associated with your Apollo.io account.
This tool returns the list of configured email accounts for sending sequences and campaigns.
Inputs: no named parameters. Returns: object
health_checkA
Check the health and authentication status of the Apollo.io API connection.
This tool verifies that the API key is valid and the service is accessible.
Inputs: no named parameters. Returns: object
search_accountsC
Search for accounts/companies in Apollo.io database.
This tool allows you to search for companies by name, location, employee count, and other criteria. Useful for finding potential prospects and account information.
Inputs: request (required). Returns: object
search_opportunitiesB
Search for opportunities in Apollo.io.
This tool searches for sales opportunities with filtering and sorting options. Useful for tracking deals and pipeline management.
Inputs: page, per_page, account_stage_ids, sort_by_field. Returns: object
search_peopleC
Search for people/contacts in Apollo.io database.
This tool allows you to search for people by job title, seniority, company domain, location, and other criteria. Returns contact information and employment details.
Inputs: request (required). Returns: object
update_accountC
Update an existing account in Apollo.io.
This tool updates account information with the provided data. Only specified fields will be updated.
Inputs: account_id (required), name, domain, phone_number. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose with no significant overlap. For example, enrich_organization and enrich_person target different entity types, while search_accounts and search_people serve different search functions. The descriptions reinforce these distinctions, making tool selection straightforward.
Most tools follow a consistent verb_noun pattern (e.g., enrich_organization, search_accounts, update_account). The only minor deviation is health_check, which uses a compound noun instead of a verb_noun structure, but this doesn't significantly impact readability or predictability.
With 11 tools, the count is well-scoped for a CRM/sales intelligence platform. Each tool serves a specific function in account management, enrichment, and search operations, with no apparent redundancy or missing core functionalities, making the set appropriately sized.
The tool set provides comprehensive coverage for account CRUD (create, get, update, search), organization and person enrichment, and opportunity search. A minor gap is the lack of update/delete operations for people or opportunities, but agents can likely work around this given the strong core functionality.
Maintenance
Related MCP Connectors
Your agent needs B2B contacts and the pipeline objects around them — find the company, find the person, get the email, then write it back where your team works. **What you can ask for** • "Find heads of engineering at Series-B SaaS companies in the Nordics, with emails." • "Enrich these companies with headcount, industry and funding." • "What roles is this company hiring for right now?" • "Create an account and a contact, then log this opportunity." • "Search our sequences for messages sent to this domain." **How to use it** Point any MCP client at https://mcp.aisa.one/apollo/mcp and sign in with OAuth — there is no key to create or paste. 54 tools: people and organisation search and enrichment, job postings, accounts, contacts, opportunities and their stages, custom fields, labels, notes, users, email accounts, sequence messages and phone-call search — reads and writes. **Why this rather than the source** The full object model, not just a search endpoint, so an agent can finish the job rather than hand you a CSV. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the person here, then ask the same agent what their company's traffic looks like or what they rank for — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/sales/mcp adds Similarweb and creator discovery around it.
Prospect, enrich leads, and manage outreach sequences with Apollo.io.
Apollo.io MCP — company and people data via api.apollo.io, the caller's OWN Apollo account (fleet…
Search companies, enrich contacts, and reveal emails and phones from your AI agent.
Related MCP Servers
- AlicenseBqualityDmaintenanceIntegrates Apollo.io's B2B sales platform with Claude AI, enabling prospect search, contact enrichment, email sequence management, list analytics, and sales intelligence operations through natural conversation.191MIT
- AlicenseAqualityDmaintenanceEnables sales intelligence and outreach automation through Apollo.io's 275M+ contact database. Supports prospecting, contact enrichment, email sequences, workflow automation, and pipeline management.345MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the Apollo.io API to search global databases and enrich company and person data. It facilitates managing contacts and accounts, retrieving tech stacks, and finding job postings through natural language.1MIT
- FlicenseBqualityDmaintenanceExposes Apollo.io API functionalities as MCP tools for people and organization enrichment, search, and job postings. Enables natural language interaction with Apollo.io data.516-