Apollo.io MCP Server

# Apollo.io MCP Server A comprehensive Model Context Protocol (MCP) server that integrates Apollo.io's powerful B2B data and sales engagement platform with Claude AI. This server enables Claude to search for prospects, enrich contact data, manage sequences, analyze lists, and perform all Apollo.io operations through natural conversation. ## Features ### 🔍 Contact & Company Search - **Search People**: Find prospects with advanced filters (title, seniority, location, industry, company) - **Search Organizations**: Discover companies by size, revenue, location, industry, and technologies - **Email Finder**: Find and verify email addresses for prospects - **Data Enrichment**: Enrich people and organizations with comprehensive B2B data ### 📧 Sequence Management - **List Sequences**: View all email sequences in your Apollo account - **Get Sequence Details**: Detailed information about specific sequences - **Analyze Sequences**: Performance metrics including open rates, reply rates, bounce rates - **Add to Sequence**: Add contacts to automated email campaigns - **Remove from Sequence**: Remove contacts from sequences ### 📋 List Operations - **Get Lists**: Retrieve all contact lists - **Scrape List Contacts**: Export all contacts from a list with full details - **Analyze Lists**: Detailed breakdown of job titles, seniorities, locations, companies, and data completeness ### 👤 Contact & Account Management - **Create Contacts**: Add new contacts to Apollo - **Update Contacts**: Modify contact information - **Create Accounts**: Add new companies/accounts - **Get Account Details**: Retrieve detailed company information - **Get Person Activity**: View engagement history for contacts ### 💼 Sales Intelligence - **Search Job Postings**: Find companies hiring (buying signals) - **Track Activity**: Monitor contact engagement and interactions ## Quick Start ### Automated Setup Run the verification script to check your setup: ```bash ./verify.sh ``` This will: - ✓ Verify Node.js version - ✓ Install dependencies if needed - ✓ Build the project - ✓ Show you the exact configuration to use ### Manual Installation #### Prerequisites - Node.js 18 or higher - An Apollo.io account with API access - Apollo.io API key ([Get yours here](https://app.apollo.io/#/settings/integrations/api)) #### Setup Steps 1. **Clone or download this repository** 2. **Install dependencies** ```bash npm install ``` 3. **Build the server** ```bash npm run build ``` 4. **Get your API key** - Go to https://app.apollo.io/#/settings/integrations/api - Copy your API key - You'll add it to Claude Desktop config (not a .env file) ## Usage ### Running with Claude Desktop Add this to your Claude Desktop configuration file: **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%/Claude/claude_desktop_config.json` ```json { "mcpServers": { "apollo": { "command": "node", "args": ["/absolute/path/to/apollo.io-mcp/build/index.js"], "env": { "APOLLO_API_KEY": "your_apollo_api_key_here" } } } } ``` Replace `/absolute/path/to/apollo.io-mcp` with the actual path to this project. ### Running with Other MCP Clients The server uses stdio transport and can be run with any MCP-compatible client: ```bash node build/index.js ``` ## Example Usage with Claude Once configured, you can ask Claude to perform Apollo.io operations naturally: ### Finding Prospects ``` "Find CTOs at Series B SaaS companies in San Francisco" "Search for VP of Sales at companies with 50-200 employees in the fintech industry" ``` ### Enriching Data ``` "Enrich the contact data for john@example.com" "Get detailed information about apollo.io" "Find the email address for John Smith at Apollo.io" ``` ### Managing Sequences ``` "Show me all my email sequences" "Analyze the performance of sequence ID abc123" "Add these contact IDs to my outbound sequence: [id1, id2, id3]" ``` ### Analyzing Lists ``` "Analyze my Enterprise Leads list" "Show me all contacts in list ID xyz789" "What's the breakdown of job titles in my Q4 Prospects list?" ``` ### Sales Intelligence ``` "Find companies hiring for Sales Director positions" "Show me the activity history for contact ID abc123" ``` ## Available Tools | Tool | Description | |------|-------------| | `search_people` | Search for contacts with advanced filters | | `search_organizations` | Search for companies by various criteria | | `enrich_person` | Enrich contact data with email, phone, socials | | `enrich_organization` | Get detailed company information | | `find_email` | Find and verify email addresses | | `list_sequences` | List all email sequences | | `get_sequence` | Get sequence details and steps | | `analyze_sequence` | Analyze sequence performance metrics | | `add_to_sequence` | Add contacts to a sequence | | `remove_from_sequence` | Remove contacts from a sequence | | `get_lists` | Get all contact lists | | `get_list_contacts` | Scrape/export contacts from a list | | `analyze_list` | Detailed list analytics and breakdown | | `create_contact` | Create new contact | | `update_contact` | Update contact information | | `create_account` | Create new account/company | | `get_account` | Get account details | | `search_job_postings` | Search job postings for buying signals | | `get_person_activity` | Get contact activity history | ## API Rate Limits Apollo.io enforces rate limits based on your plan: - **Free Plan**: 50 credits/month - **Basic Plan**: 1,200 credits/month - **Professional Plan**: 12,000 credits/month - **Organization Plan**: Custom limits Each API call consumes credits. Monitor your usage in the Apollo.io dashboard. ## Troubleshooting ### Quick Checks 1. **Run the verification script**: ```bash ./verify.sh ``` 2. **Common issues**: - ✗ Using relative path instead of absolute path - ✗ API key not set in config - ✗ Forgot to restart Claude Desktop - ✗ Config JSON has syntax errors - ✗ Wrong config file location ### Detailed Troubleshooting See **[TROUBLESHOOTING.md](./TROUBLESHOOTING.md)** for comprehensive solutions to: - Server not appearing in Claude Desktop - API key errors - Module not found errors - Network/API issues - Build failures - Log checking and debug mode ### Quick Fix If nothing works, try a complete reset: ```bash cd /path/to/apollo.io-mcp rm -rf node_modules build package-lock.json npm install npm run build chmod +x build/index.js # Then restart Claude Desktop ``` ## Development ### Watch mode ```bash npm run watch ``` ### Testing manually ```bash npm run dev ``` ## Resources - [Apollo.io API Documentation](https://docs.apollo.io/) - [Model Context Protocol Documentation](https://modelcontextprotocol.io/) - [Apollo.io API Key Management](https://app.apollo.io/#/settings/integrations/api) ## License MIT ## Contributing Contributions are welcome! Please feel free to submit a Pull Request. ## Support For issues related to: - **This MCP Server**: Open an issue in this repository - **Apollo.io API**: Contact [Apollo.io Support](https://knowledge.apollo.io/) - **MCP Protocol**: Visit [MCP Documentation](https://modelcontextprotocol.io/) --- Built with ❤️ using the Model Context Protocol