apollo-mcp

Apollo.io MCP Server

FastMCP server exposing the full operational surface of the Apollo.io REST API to Claude Code. 27 tools covering sequences, campaign health, mailbox warmup, people/org enrichment, CRM contacts, tasks, labels, credit tracking, AND programmatic template/sequence/mailbox-cap editing with audit logging.

Most existing Apollo MCPs only expose people search and enrichment. This one is built for teams running outbound at scale — daily health digests, sequence management, mailbox deliverability monitoring, programmatic contact enrollment, and end-to-end sequence authoring without touching the Apollo UI.

Quick reference

apollo_campaign_health                — daily digest (start here)
apollo_messages_search days_back=1    — raw send/open/reply/bounce log
apollo_mailbox_warmup                 — per-mailbox deliverability state
apollo_sequences_list                 — all sequences + labels + stats
apollo_sequence_add_contacts ...      — enroll contacts into a sequence
apollo_template_update ...            — update template body + subject (with audit log)
apollo_sequence_create ...            — author a new sequence end-to-end
apollo_step_create ...                — add a step + template to a sequence
apollo_mailbox_update_cap ...         — change daily send cap
apollo_credits_remaining              — monthly credit budget check
apollo_health                         — self-check (also probes master key)

Tool inventory (27)

Campaign health

• apollo_campaign_health(days_back=1) — digest across all sequences + mailboxes
• apollo_mailbox_warmup() — per-mailbox warmup status and daily limits
• apollo_sequence_get(sequence_id) — one-sequence deep-dive

Sequences

• apollo_sequences_list() — list all sequences with stats
• apollo_sequence_add_contacts(sequence_id, contact_ids, send_email_from_email_account_id?)
• apollo_sequence_remove_contacts(sequence_id, contact_ids)
• apollo_sequence_set_active(sequence_id, active) — activate or pause

Messages / analytics

• apollo_messages_search(days_back, sequence_ids?, stats?, per_page, max_pages)

People / orgs

• apollo_people_search(...) — free (no credit burn)
• apollo_person_enrich(...) — 1 credit per revealed email
• apollo_bulk_person_enrich(people, reveal_personal_emails?) — up to 10/call
• apollo_org_search(...)
• apollo_org_enrich(domain)
• apollo_org_job_postings(organization_id)

CRM

• apollo_contacts_search(...)
• apollo_contact_create(...)
• apollo_contact_update(contact_id, fields)
• apollo_contact_stages()

Tasks / labels / credits

• apollo_task_create(...)
• apollo_labels_list()
• apollo_label_create(name)
• apollo_credits_remaining()

Template + sequence authoring (destructive writes)

• apollo_template_get(template_id) — fetch current template state
• apollo_template_update(template_id, subject?, body_text?, body_html?, audit_label?) — update template subject + body. Snapshots current state to APOLLO_AUDIT_LOG_PATH (if set) BEFORE the write so any breakage is reversible from the diff
• apollo_sequence_create(name, label?, permissions?, active?) — create a new sequence (paused by default)
• apollo_step_create(sequence_id, position, wait_days, subject, body_text, body_html?, step_type?, include_signature?) — create a step + touch + template in one call
• apollo_mailbox_update_cap(mailbox_id, daily_send_limit, audit_label?) — change daily send cap on a mailbox. Audits before/after.

Diagnostics

• apollo_health() — probes API key validity + master-key hint

Configuration

Copy config.example.yaml to config.yaml and fill in your values:

cp config.example.yaml config.yaml