How to integrate Apollo MCP with Atomic Agent

Connect Atomic Agent to Apollo MCP. Bulk enrich profiles for new leads, add contacts to outreach sequence now, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Apollo

Api Key

Apollo is a CRM and lead generation platform that helps businesses discover contacts and manage sales pipelines. Use it to streamline customer outreach and track your deals from one place.

48 Tools

Managed auth

Connect Apollo without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Apollo.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Apollo account. See the Atomic Agent documentation for installation instructions.

How Atomic Agent connects to Apollo

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Apollo to Atomic Agent

Sign up or sign in to the Composio dashboard. Copy your API key.
In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
Ask Atomic Agent to do something in Apollo. It searches Composio for the right tool.
On first use, open the sign-in link returned in the chat. Connect your Apollo account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash

COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Apollo MCP server, and what's possible with it?

The Apollo MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Apollo account. It provides structured and secure access to your CRM and lead generation data, so your agent can create contacts, enrich organizations, manage deals, update account stages, and automate tasks for your sales pipeline—all on your behalf.

Contact and account creation: Instantly add new contacts or accounts to Apollo, linking them to organizations and stages to keep your CRM up to date with zero manual entry.
Bulk data enrichment: Rapidly enrich multiple people or organizations at once, leveraging Apollo's database to fill gaps and update your records with the latest information.
Sales opportunity and pipeline management: Let your agent create new deals, retrieve opportunity stages, and move accounts through your sales funnel to optimize pipeline performance.
Automated outreach sequencing: Add contacts to email sequences, making it easy to launch targeted campaigns and follow-ups without lifting a finger.
Task creation and label organization: Generate actionable Apollo tasks for your team and organize contacts or accounts with labels, so nothing slips through the cracks.

Use Apollo from Atomic Agent

With your account connected, ask Atomic Agent to work with Apollo in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Apollo action and event your agent gets out of the box.

Add Contacts to Sequence

Adds contacts to a specified Apollo email sequence and returns the contact details.

Bulk organization enrichment

Enriches data for up to 10 organizations simultaneously by providing a list of their base company domains (e.

Bulk people enrichment

Use to enrich multiple person profiles simultaneously with comprehensive data from Apollo's database.

Bulk update account stage

Bulk updates the stage for specified existing Apollo.

Create an Apollo account

Creates a new account in Apollo.

Bulk create Apollo accounts

Creates multiple accounts in Apollo.

Bulk create Apollo contacts

Tool to bulk create multiple contacts in Apollo with a single API call.

Create call record in Apollo

Tool to log call records in Apollo from external systems.

Create Apollo contact

Creates a new contact in Apollo.

Create custom field

Creates a new custom field in Apollo.

Create Apollo deal

Creates a new sales opportunity (deal) in Apollo.

Create Apollo Task

Tool to create a single task in Apollo.

Get Account by ID

Tool to retrieve detailed information about a specific account by its Apollo ID.

Check Apollo API key status

Tool to check whether the provided Apollo API key is valid and accepted by Apollo (health/auth check).

Get Apollo Contact

Retrieves detailed information about a specific contact by its ID.

Get Apollo deal

Retrieves information about a specific deal by its ID.

Get Labels

Retrieves all labels from Apollo.

Get opportunity stages

Retrieves all configured opportunity (deal) stages from the Apollo.

Get Organization by ID

Retrieves complete information about a specific organization by its Apollo ID.

Get Organization Job Postings

Retrieves paginated job postings for a specified organization by its ID, optionally filtering by domain; ensure `organization_id` is a valid identifier.

Get typed custom fields

Retrieves all typed custom field definitions available in the Apollo.

List Apollo account stages

Retrieves the IDs for all available account stages in your team's Apollo account.

List apollo contact stages

Retrieves all available contact stages from an Apollo account, including their unique IDs and names.

List Apollo deals

Retrieves a list of deals from Apollo, using Apollo's default sort order if 'sort_by_field' is omitted.

List email accounts

Retrieves all email accounts and their details for the authenticated user; takes no parameters.

List Fields

Retrieves all field definitions from Apollo.

List Apollo Users

Retrieves a list of all users (teammates) associated with the Apollo account, supporting pagination via `page` and `per_page` parameters.

Enrich organization data

Fetches comprehensive organization enrichment data from Apollo.

Search organizations in Apollo

Searches Apollo's database for organizations using various filters; consumes credits on every call (unavailable on free plans) — avoid re-running identical queries and surface quota errors rather than retrying.

Enrich person with Apollo

Enriches and retrieves information for a person from Apollo.

Apollo people search

Searches Apollo's contact database for people using various filters; results capped at 50,000 records and does not enrich contact data.

Search Apollo Accounts

Searches for accounts within your existing Apollo.

Search for Calls

Searches for call records in Apollo.

Search Apollo contacts

Searches Apollo contacts using keywords, stage IDs (from 'List Contact Stages' action), or sorting (max 50,000 records; `sort_ascending` requires `sort_by_field`).

Search news articles

Tool to search for news articles about companies in Apollo's database.

Search outreach emails

Tool to search for outreach emails sent through Apollo sequences.

Search sequences

Searches for sequences (e.

Search tasks

Searches for tasks in Apollo.

Update an Apollo account

Updates specified attributes of an existing account in Apollo.

Update account ownership

Updates the ownership of multiple Apollo accounts to a specified user.

Update Apollo call record

Tool to update an existing call record in Apollo.

Update Apollo contact details

Tool to update an existing contact's information in Apollo.

Update contact ownership

Updates the ownership of specified Apollo contacts to a given Apollo user, who must be part of the same team.

Bulk update Apollo contacts

Tool to bulk update multiple Apollo contacts with a single API call.

Update contact stage

Updates the stage for one or more existing contacts in Apollo.

Update contact status in sequence

Updates a contact's status within a designated Apollo sequence, but cannot set the status to 'active'.

Update Apollo deal

Updates specified fields of an existing Apollo.

View API Usage Stats

Fetches Apollo API usage statistics and rate limits for the connected team.

FRAMEWORKS

How to build Apollo MCP Agent with another framework

ChatGPT

Use Apollo MCP with ChatGPT

Antigravity

Use Apollo MCP with Antigravity

OpenAI Agents SDK

Use Apollo MCP with OpenAI Agents SDK

Claude Agent SDK

Use Apollo MCP with Claude Agent SDK

Claude Code

Use Apollo MCP with Claude Code

Claude Cowork

Use Apollo MCP with Claude Cowork

Grok Bot

Use Apollo MCP with Grok Bot

Codex

Use Apollo MCP with Codex

Grok Build

Use Apollo MCP with Grok Build

Cursor

Use Apollo MCP with Cursor

VS Code

Use Apollo MCP with VS Code

OpenCode

Use Apollo MCP with OpenCode

OpenClaw

Use Apollo MCP with OpenClaw

Hermes

Use Apollo MCP with Hermes

Google ADK

Use Apollo MCP with Google ADK

LangChain

Use Apollo MCP with LangChain

Vercel AI SDK

Use Apollo MCP with Vercel AI SDK

Mastra AI

Use Apollo MCP with Mastra AI

LlamaIndex

Use Apollo MCP with LlamaIndex

CrewAI

Use Apollo MCP with CrewAI

Pydantic AI

Use Apollo MCP with Pydantic AI

AutoGen

Use Apollo MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

HubSpot

Oauth2Api Key

HubSpot is an all-in-one marketing, sales, and customer service platform. It lets teams nurture leads, automate outreach, and track every customer interaction in one place.

Pipedrive

Oauth2Api Key

Pipedrive is a sales management platform offering pipeline visualization, lead tracking, and workflow automation. It helps sales teams keep deals moving forward efficiently and never miss a follow-up.

Salesforce

Oauth2S2s Oauth2

Salesforce is a leading CRM platform that helps businesses manage sales, service, and marketing. It centralizes customer data, enabling teams to drive growth and build strong relationships.

Attio

Oauth2

Attio is a customizable CRM and workspace for managing your team's relationships and workflows. It helps teams organize contacts, automate tasks, and collaborate more efficiently.

FAQ

Frequently asked questions

With a standalone Apollo MCP server, the agents and LLMs can only access a fixed set of Apollo tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Apollo and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Apollo tools.

Yes, absolutely. You can configure which Apollo scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Apollo data and credentials are handled as safely as possible.

Start with Apollo.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Apollo tool your agent needs.Free to start.

Start building