How to connect Apolloio to Claude Code

1. 1. Enable Apolloio in Metorial

   In your Metorial portal, enable the Apolloio MCP server and sign in with the account that owns the data. Access stays governed by your team policies.

2. 2. Add the server over HTTP

   Add --scope user to use it in every project.

   Copy

   claude mcp add --transport http metorial <your-magic-mcp-url>

3. 3. Sign in

   Run /mcp, select Metorial and sign in to load Apolloio tools.

• Create Deal: Create a new deal (opportunity) in Apollo to track account activity including monetary values, deal owners, and stages.
• Update Contact: Update an existing contact in your Apollo account.
• List Users: Retrieve all users (teammates) in your Apollo organization.
• Update Contact Sequence Status: Mark contacts as finished in a sequence, remove them from the sequence, or stop their sequence progress.
• Get Deal: Retrieve full details of a specific deal by its ID, including monetary value, stage, owner, and associated account information.
• Search Organizations: Search Apollo's company database to find organizations matching specific criteria.
• Search People: Search Apollo's database of 275M+ contacts to find prospects based on demographic filters.
• Create Task: Create one or more tasks in Apollo to track upcoming actions like emailing or calling contacts.
• Search Contacts: Search for contacts that have been added to your Apollo account.
• Update Deal: Update an existing deal in Apollo.
• Search Sequences: Search for email sequences in your Apollo account.
• Create Account: Create a new account (company) in your Apollo database.
• List Stages: Retrieve available stages for contacts, accounts, and deals.
• Add Contacts to Sequence: Add one or more contacts to an existing email sequence.
• List Deals: List all deals (opportunities) in your Apollo account.
• And 26 more on the Apolloio MCP server page.

• Apolloio tools appear as mcp__metorial__<tool>. Use that name in permission rules to allow or deny a tool.
• Run /mcp to see whether Metorial is connected and to sign in again.
• Claude Code warns when a tool result passes 10,000 tokens and caps it at 25,000 by default. Raise the cap with MAX_MCP_OUTPUT_TOKENS.
• Pre-approve trusted Apolloio tools with allow rules in your settings so Claude Code stops asking each time.

claude mcp list shows "Needs authentication"

Run /mcp, select Metorial, and sign in. If sign-in keeps failing, choose Clear authentication in the same menu and sign in again.

A teammate sees "Pending approval"

Servers shared through a project .mcp.json need approval. Run claude in the project and approve Metorial when asked.

Large tool results are cut off

Claude Code limits MCP tool output to 25,000 tokens by default. Raise it with the MAX_MCP_OUTPUT_TOKENS environment variable.

Based on the Claude Code MCP documentation.