Apollo.io MCP Server

A Model Context Protocol (MCP) server for the Apollo.io API -- giving AI coding assistants like Claude Code, Cursor, and any MCP-compatible client direct access to Apollo.io's sales intelligence platform.

Search leads, enrich contacts with verified emails and phone numbers, manage CRM records, run email sequences, track outreach, manage deals, tasks, notes, labels, and more -- all through natural language via 45 ready-to-use tools.

Why Use This?

• AI-native prospecting -- Ask your AI assistant to "find CTOs at Series B fintech companies in NYC" and get results instantly
• Automated enrichment -- Enrich leads with verified emails and phone numbers without leaving your editor
• CRM operations -- Create, update, search, and delete contacts, accounts, deals, tasks, and notes through conversation
• Sequence management -- Add contacts to email sequences and monitor outreach performance
• Full pipeline visibility -- Access contact stages, account stages, opportunity stages, labels, and team members
• Credit-aware -- Every tool description includes credit cost so your AI avoids unexpected charges

Quick Start

1. Clone & Build

git clone https://github.com/Chainscore/apollo-io-mcp.git
cd apollo-io-mcp
npm install
npm run build

2. Get Your Apollo API Key

Get your API key from Apollo.io Settings > Integrations > API.

3. Add to Your MCP Client

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "apollo-io": {
      "command": "node",
      "args": ["/path/to/apollo-io-mcp/dist/index.js"],
      "env": {
        "APOLLO_API_KEY": "your_key_here"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "apollo-io": {
      "command": "node",
      "args": ["/path/to/apollo-io-mcp/dist/index.js"],
      "env": {
        "APOLLO_API_KEY": "your_key_here"
      }
    }
  }
}

Tools (45)

People Search & Enrichment

Tool	Description	Cost
search_people	Search Apollo's 270M+ contact database by title, company, location, seniority, tech stack, funding stage	FREE
enrich_person	Get verified email, phone number, and full profile for a person	1 credit
bulk_enrich_people	Enrich up to 10 people in a single request	1 credit/person

Company / Organization Data

Tool	Description	Cost
search_organizations	Search companies by name, industry, employee count, revenue	1 credit/page
enrich_organization	Get detailed company info (tech stack, funding, size) by domain	1 credit
get_organization	Get organization details by Apollo ID	FREE
get_organization_job_postings	Get current job postings for a company	1 credit

CRM -- Contacts

Tool	Description	Cost
create_contact	Create a contact with automatic deduplication	FREE
update_contact	Update an existing contact	FREE
get_contact	Retrieve a contact by ID	FREE
search_contacts	Search your saved contacts	FREE
delete_contact	Permanently delete a contact	FREE
bulk_create_contacts	Create up to 100 contacts at once	FREE
bulk_update_contacts	Update up to 100 contacts at once	FREE

CRM -- Accounts

Tool	Description	Cost
create_account	Create a company record in your CRM	FREE
update_account	Update an existing account	FREE
search_accounts	Search your saved accounts	FREE

CRM -- Opportunities/Deals

Tool	Description	Cost
search_opportunities	Search deals in your pipeline by keyword, stage, or owner	FREE
get_opportunity	Get a single deal by ID	FREE
create_opportunity	Create a new deal with name, amount, stage, contacts	FREE
update_opportunity	Update deal details, stage, or amount	FREE

CRM -- Tasks

Tool	Description	Cost
search_tasks	Search tasks by keyword, assignee, or completion status	FREE
get_task	Get a single task by ID	FREE
create_task	Create a call, email, linkedin, or other task	FREE
update_task	Update task details or mark as completed	FREE

CRM -- Notes

Tool	Description	Cost
search_notes	Search notes by keyword or contact	FREE
create_note	Create a note, optionally attached to a contact	FREE
delete_note	Delete a note	FREE

Email Sequences & Outreach

Tool	Description	Cost
search_sequences	Search email sequences/campaigns	FREE
add_contacts_to_sequence	Add contacts to an email sequence	FREE
update_sequence_status	Remove or pause contacts in a sequence	FREE
search_outreach_emails	Search sent outreach emails with open/click tracking	FREE
get_email_activities	Get opens, clicks, and replies for an email	FREE
list_email_accounts	List connected sending email accounts	FREE

Labels & Tags

Tool	Description	Cost
list_labels	List all labels/tags in your workspace	FREE
create_label	Create a new label for contacts or accounts	FREE
update_label	Rename an existing label	FREE
delete_label	Delete a label	FREE

Pipeline Stages

Tool	Description	Cost
list_contact_stages	List contact pipeline stages (Cold, Approaching, etc.)	FREE
list_account_stages	List account pipeline stages	FREE
list_opportunity_stages	List deal pipeline stages (Lead, Qualified, Won, etc.)	FREE

Team & Users

Tool	Description	Cost
search_users	Search team members by name or email	FREE

Activity Tracking

Tool	Description	Cost
search_activities	Search activity logs (emails, calls, clicks, replies)	FREE
search_phone_calls	Search phone call records and outcomes	FREE

Custom Fields & Metadata

Tool	Description	Cost
list_fields	List all available fields for contacts/accounts	FREE
create_custom_field	Create a custom field (text, number, dropdown, etc.)	FREE
list_custom_fields_deprecated	List custom fields via legacy endpoint	FREE

News, Usage & Health

Tool	Description	Cost
search_news_articles	Search recent news about target companies	Credits
get_api_usage_stats	Check API credit usage and remaining balance	FREE
health_check	Verify API key and check Apollo API health	FREE

Usage Tips

• Verify your setup -- Start with health_check or get_api_usage_stats (both FREE) to confirm your API key works
• Save credits -- Use search_people (FREE) for prospecting before enriching with enrich_person (1 credit)
• Prefer people search -- search_people is free while search_organizations costs 1 credit/page
• Auto-cleaned domains -- Pass https://www.google.com, www.google.com, or @google.com -- all resolve to google.com
• Built-in deduplication -- Contact creation enforces dedup so you never accidentally create duplicates
• Pipeline workflow -- Use list_contact_stages / list_opportunity_stages to get stage IDs, then filter contacts and deals by stage
• Task management -- Create tasks with create_task, assign to team members found via search_users
• Label organization -- Create labels with create_label, then apply them when creating/updating contacts

Requirements

• Node.js 18+
• Apollo.io API key (get one here)
• An MCP-compatible client (Claude Code, Cursor, etc.)

License

MIT

Contact

Need help integrating this MCP server into your workflow? Reach out at prasad@chainscorelabs.com. We help companies build agentic workflows seemlessly that saves time and money.

Built by Chainscore.