Apolloio MCP

Apollo.io MCP Server

The official Apollo.io Model Context Protocol server for prospecting, lead enrichment, sales intelligence, and outreach workflows.

Provider: Official, first-party server built and maintained by Apollo.io.

Bring Apollo.io prospecting, enrichment, and outreach directly into your favorite MCP-compatible AI application — GitHub Copilot, Visual Studio Code, Cursor, Claude Code, Claude Desktop, and Claude Cowork.

• Apollo.io: https://www.apollo.io/
• Model Context Protocol: https://modelcontextprotocol.io/
• License: MIT

---

Table of Contents

• Overview
• Key Capabilities
• Prerequisites
• Install in Visual Studio Code and GitHub Copilot
• Install in Cursor
• Install in Claude Code
• Install in Claude Desktop or Claude Cowork
• Generic MCP Client Configuration
• Authentication and Authorization
• Usage Examples
• Available Tools and Capabilities
• Model Recommendations
• Safety and Responsible Usage
• Privacy and Data Handling
• Troubleshooting
• Official MCP Registry
• Development and Contribution
• Versioning and Releases
• Security
• Support
• Credits
• License

---

Overview

The Apollo.io MCP server exposes Apollo.io's go-to-market data and workflows through the Model Context Protocol, so MCP-compatible AI applications can prospect for people and companies, enrich contacts, query sales analytics, and load leads into outreach sequences using natural language.

• Hosted and maintained by Apollo.io. The server runs remotely — there is nothing to build, host, or run locally.
• Transport: Streamable HTTP.
• Endpoint:

  https://mcp.apollo.io/mcp

• Authentication: Handled through Apollo.io OAuth. You sign in with your Apollo.io account and authorize access from your MCP client; the server then acts with your Apollo.io permissions. See Authentication and Authorization.

This repository also ships an optional Apollo plugin for Claude Code and Cowork that bundles ready-made workflow skills (/apollo:* commands) on top of the same MCP server.

---

Key Capabilities

The following capabilities are confirmed by the server tools and skills in this repository:

• People prospecting — search Apollo's people database by title, seniority, location, and company attributes.
• Company prospecting — search organizations by industry, size, location, and keywords.
• Contact and account enrichment — match and enrich people and organizations, individually or in bulk.
• Outreach sequence workflows — find sequences, and add or remove/stop contacts in a sequence.
• Sales analytics — query email, call, meeting, task, opportunity, sequence, and conversation-intelligence metrics and return formatted breakdowns.
• Contact management — create Apollo contacts as part of enrichment and sequence-loading workflows.

The remote server may expose additional tools beyond those exercised by the bundled skills. The list above reflects what is confirmed in this repository. See Available Tools and Capabilities.

---

Prerequisites

• An Apollo.io account. Sign in at https://www.apollo.io/.
• Apollo.io permissions and credits. Actions run with your account's permissions, and some actions consume Apollo credits (for example, enrichment). See Safety and Responsible Usage. For plan, credit, and permission details, see the Apollo documentation.

• An MCP-compatible client that supports the Streamable HTTP transport, such as:
• GitHub Copilot in Visual Studio Code
• Cursor
• Claude Code
• Claude Desktop / Claude Cowork
• Other MCP clients (see Generic MCP Client Configuration)
• No local runtime required. The server is remote and hosted by Apollo.io — you do not need Node.js, Docker, or a local installation to use it. (The optional Claude Code / Cowork plugin installs workflow skills locally through your client's plugin system, but the MCP server itself remains remote.)

---

Install in Visual Studio Code and GitHub Copilot

The Apollo.io MCP server is published in the official Model Context Protocol Registry, but it is not yet discoverable in the curated GitHub MCP Registry or the VS Code MCP gallery. Until then, add it manually with the configuration below.

Option A — workspace configuration file

Create a .vscode/mcp.json file in your workspace:

{

"servers": { "apollo": { "type": "http", "url": "https://mcp.apollo.io/mcp" } } }

Option B — command palette

1. Open the Command Palette (Cmd/Ctrl + Shift + P).
2. Run MCP: Add Server.
3. Choose the HTTP (Streamable HTTP) server type when prompted.
4. Enter the URL https://mcp.apollo.io/mcp and name the server apollo.

Expected authentication and first run

1. Add the MCP server using either option above.
2. Start or enable the apollo server.
3. Complete Apollo.io authentication in the browser window that opens.
4. Approve the requested access for your Apollo.io workspace.
5. Open Copilot Chat in Agent mode.
6. Confirm that the Apollo tools are listed and available to the agent.

For the current terminology and behavior, see the VS Code documentation on MCP servers: https://code.visualstudio.com/docs/copilot/chat/mcp-servers.

---

Install in Cursor

Add the remote Streamable HTTP endpoint to your Cursor MCP configuration (for example, ~/.cursor/mcp.json, or the project-level .cursor/mcp.json):

{

"mcpServers": { "apollo": { "type": "http", "url": "https://mcp.apollo.io/mcp" } } }

Then:

1. Open Cursor settings and confirm the apollo server is listed under MCP.
2. Authenticate with your Apollo.io account when prompted.
3. Approve the requested access, then use Apollo tools from the agent.

This repository also includes a Cursor plugin manifest (.cursor-plugin/plugin.json) that references the same remote endpoint (.mcp.json), so no local package needs to run.

---

Install in Claude Code

You can connect the server in either of two ways.

Option A — add the remote MCP server directly

claude mcp add --transport http apollo https://mcp.apollo.io/mcp

Then run /mcp inside Claude Code, select apollo, and authenticate.

Option B — install the Apollo plugin (adds /apollo:* workflow skills)

1. Add this plugin's marketplace:

   /plugin marketplace add apolloio/apollo-mcp-plugin

1. Install the plugin:

   /plugin install apollo@apollo-plugin-marketplace

1. Restart Claude Code so the MCP server starts correctly.

The plugin automatically configures the Apollo MCP server — no manual config files. After installing, authenticate with /mcp and run /apollo:* commands (see Available Tools and Capabilities).

---

Install in Claude Desktop or Claude Cowork

Claude Desktop and Claude Cowork are separate from Claude Code (the CLI). Use the steps below for the desktop-based clients.

Cowork (one-click)

Click to install in a single step:

[Install in Cowork](https://claude.ai/desktop/customize/plugins/new?marketplace=apolloio/apollo-mcp-plugin&plugin=apollo)

Then restart Cowork so the MCP server starts correctly.

Claude Desktop

Add the Apollo connector from your Claude settings, then authenticate:

1. Open Settings and connect the Apollo.io connector (Apollo appears as a remote MCP server).
2. Complete Apollo.io authentication in your browser.
3. Approve the requested access.
4. Confirm Apollo tools are available in a new chat.

Exact menu labels and navigation vary by Claude Desktop version. See Anthropic's documentation for the current steps to add a remote MCP connector.

---

Generic MCP Client Configuration

For any other MCP-compatible client that supports Streamable HTTP:

{

"name": "apollo", "type": "streamable-http", "url": "https://mcp.apollo.io/mcp" }

Exact property names vary between clients. Some clients use type: "http" (as in the VS Code and Cursor examples above) and some use type: "streamable-http". Consult your client's MCP documentation for the precise schema.

---

Authentication and Authorization

The Apollo MCP server uses Apollo.io OAuth. Only confirmed behavior is documented here.

• Sign-in flow. When you connect the server, your client opens an Apollo.io sign-in and authorization window. After you approve access, your client can call Apollo tools on your behalf.
• Workspace and permissions. The server acts with the authenticated user's Apollo.io permissions. You can only access data and perform actions your Apollo.io account is allowed to.
• Reconnecting. In Claude Code you can re-run /mcp, select apollo, and re-authenticate. In other clients, re-trigger authentication from the client's MCP or connector settings.
• Revoking access. Remove or disconnect the apollo server from your MCP client to stop it from acting on your behalf. To manage authorizations at the account level, use your Apollo.io account settings.

OAuth authorization-server metadata is discoverable at https://mcp.apollo.io/.well-known/oauth-authorization-server. Beyond that, this README does not assert a specific OAuth specification or profile.

---

Usage Examples

Natural-language prompts you can try once the server is connected:

Find software engineering leaders at B2B SaaS companies in Germany with 200–1,000 employees.

Enrich these business contacts and return their current title, company, and verified business email when available.

Show email and call performance by rep for this quarter, sorted by calls made.

Add the selected contacts to my Apollo sequence "Q1 Enterprise Outbound" — show a preview before enrolling.

If you installed the Claude Code / Cowork plugin, the same workflows are available as slash commands:

• /apollo:prospect VP of Engineering at Series B+ SaaS companies in the US, 200-1000 employees
• /apollo:enrich-lead https://www.linkedin.com/in/example
• /apollo:sequence-load add 20 VP Sales at SaaS companies to my "Q1 Outbound" sequence
• /apollo:analytics Show me team call connect rate this quarter by rep

Review before you act. For consequential actions — enrichment (credit-consuming) and adding contacts to a sequence (potentially outbound) — review the exact targets and parameters before confirming the operation.

---

Available Tools and Capabilities

The remote server provides the underlying Apollo tools; the tools listed below are those confirmed in this repository through the bundled workflow skills. The full, authoritative tool set is provided by the remote server and may evolve independently of this document.

Workflow skills (Claude Code / Cowork plugin)

High-value skills that chain multiple Apollo to