Skip to main content
Glama
Apollo.io MCP Server

Apollo.io MCP Server

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

  1. Clone or create the project:

    mkdir apollo-mcp-server
    cd apollo-mcp-server
  2. Install UV (if not already installed):

    curl -LsSf https://astral.sh/uv/install.sh | sh
  3. Install dependencies:

    uv sync
  4. Set up environment variables:

    cp .env.example .env
    # Edit .env and add your Apollo.io API key

Configuration

Apollo.io API Key

  1. Log in to your Apollo.io account

  2. Go to Settings → Integrations → API

  3. Generate or copy your API key

  4. Add it to your .env file:

    APOLLO_API_KEY=your_actual_api_key_here

Usage

Running the Server

uv run python src/apollo_mcp_server.py

Or using the installed script:

uv run apollo-mcp-server

Available Tools

search_accounts({
    "q_organization_name": "Google",
    "organization_locations": ["California, US"],
    "organization_num_employees_ranges": ["1000,10000"],
    "page": 1,
    "per_page": 25
})
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 pytest

Code 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:

  1. Separate Bombora API integration

  2. Data correlation between Apollo.io contacts and Bombora intent signals

  3. Custom enrichment workflows

Contact Apollo.io support for information about intent data partnerships and availability.

Support

For issues with this MCP server:

  1. Check the error messages and logs

  2. Verify your API key is valid

  3. Ensure you have sufficient API credits

  4. 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 tools
bulk_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

    B3.4/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    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.

      https://mcp.apollo.io/mcp
    • 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.

      https://mcp.fiber.ai/mcp

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Integrates 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.
      19
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      1
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Exposes Apollo.io API functionalities as MCP tools for people and organization enrichment, search, and job postings. Enables natural language interaction with Apollo.io data.
      5
      16
      -