146 lines
4.4 KiB
Markdown
146 lines
4.4 KiB
Markdown
# Apollo.io MCP Server
|
|
|
|
MCP server for Apollo.io sales intelligence and engagement platform. Provides AI-powered access to contacts, accounts, sequences, enrichment, and more.
|
|
|
|
## Features
|
|
|
|
- **Contact Management**: List, search, create, update, and enrich contacts
|
|
- **Account Intelligence**: Manage and search companies with firmographic data
|
|
- **Email Sequences**: Create and manage automated outreach campaigns
|
|
- **Data Enrichment**: Enrich people and companies with Apollo's B2B database
|
|
- **Advanced Search**: Search 250M+ contacts and 60M+ companies
|
|
- **Email Tools**: Send emails, manage threads, and track engagement
|
|
- **Task Management**: Create and track follow-up tasks
|
|
- **Opportunity Tracking**: Manage deals and pipeline
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Required | Description | Example |
|
|
|----------|----------|-------------|---------|
|
|
| `APOLLO_API_KEY` | ✅ | Apollo.io API key | `abc123...` |
|
|
| `APOLLO_BASE_URL` | ❌ | API base URL (optional) | `https://api.apollo.io/v1` |
|
|
|
|
## Getting Your API Key
|
|
|
|
1. Log in to [Apollo.io](https://app.apollo.io/)
|
|
2. Navigate to **Settings** > **Integrations** > **API**
|
|
3. Click **Generate New Key** or copy your existing key
|
|
4. Set the environment variable:
|
|
```bash
|
|
export APOLLO_API_KEY="your-api-key-here"
|
|
```
|
|
|
|
## Required API Scopes
|
|
|
|
Apollo.io API keys have full access to your account data. Ensure your key is kept secure and not committed to version control.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm install
|
|
npm run build
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Stdio Mode (Default)
|
|
```bash
|
|
node dist/main.js
|
|
```
|
|
|
|
### With Claude Desktop
|
|
Add to your `claude_desktop_config.json`:
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"apollo": {
|
|
"command": "node",
|
|
"args": ["/path/to/apollo/dist/main.js"],
|
|
"env": {
|
|
"APOLLO_API_KEY": "your-api-key-here"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Tools Overview
|
|
|
|
### Contacts (8 tools)
|
|
- `apollo_list_contacts` - List contacts with pagination
|
|
- `apollo_get_contact` - Get contact by ID
|
|
- `apollo_search_contacts` - Advanced contact search
|
|
- `apollo_create_contact` - Create new contact
|
|
- `apollo_update_contact` - Update contact details
|
|
- `apollo_delete_contact` - Delete contact
|
|
- `apollo_enrich_contact` - Enrich existing contact
|
|
- `apollo_list_account_contacts` - List contacts for an account
|
|
|
|
### Accounts (5 tools)
|
|
- `apollo_list_accounts` - List accounts with pagination
|
|
- `apollo_get_account` - Get account by ID
|
|
- `apollo_search_accounts` - Advanced account search
|
|
- `apollo_create_account` - Create new account
|
|
- `apollo_update_account` - Update account details
|
|
|
|
### Sequences (8 tools)
|
|
- `apollo_list_sequences` - List email sequences
|
|
- `apollo_get_sequence` - Get sequence by ID
|
|
- `apollo_create_sequence` - Create new sequence
|
|
- `apollo_add_contacts_to_sequence` - Enroll contacts
|
|
- `apollo_remove_contacts_from_sequence` - Remove contacts
|
|
- `apollo_create_sequence_step` - Add step to sequence
|
|
- `apollo_list_email_templates` - List email templates
|
|
- `apollo_get_email_stats` - Get email engagement stats
|
|
|
|
### Emails (4 tools)
|
|
- `apollo_send_email` - Send one-off email
|
|
- `apollo_list_email_accounts` - List connected email accounts
|
|
- `apollo_list_email_threads` - List email threads
|
|
- `apollo_get_email_thread` - Get thread by ID
|
|
|
|
### Tasks (3 tools)
|
|
- `apollo_list_tasks` - List tasks with filters
|
|
- `apollo_create_task` - Create new task
|
|
- `apollo_update_task` - Update task status/details
|
|
|
|
### Opportunities (3 tools)
|
|
- `apollo_list_opportunities` - List deals/opportunities
|
|
- `apollo_create_opportunity` - Create new opportunity
|
|
- `apollo_update_opportunity` - Update opportunity details
|
|
|
|
### Enrichment (3 tools)
|
|
- `apollo_enrich_person` - Enrich person by email/name
|
|
- `apollo_enrich_company` - Enrich company by domain
|
|
- `apollo_bulk_enrich` - Batch enrich up to 25 people
|
|
|
|
### Search (2 tools)
|
|
- `apollo_search_people` - Search 250M+ contacts
|
|
- `apollo_search_companies` - Search 60M+ companies
|
|
|
|
## Coverage Manifest
|
|
|
|
**Total Apollo.io API endpoints**: ~80
|
|
**Tools implemented**: 36
|
|
**Intentionally skipped**: 44 (admin-only endpoints, deprecated methods, duplicate functionality)
|
|
**Coverage**: 36/80 = 45%
|
|
|
|
### Skipped Endpoints
|
|
- Admin/team management (user provisioning, team settings)
|
|
- Legacy v0 API endpoints
|
|
- Internal webhook configuration
|
|
- Billing and subscription management
|
|
- Advanced analytics (available via dashboard)
|
|
|
|
## Development
|
|
|
|
```bash
|
|
npm run dev # Watch mode with tsx
|
|
npm run build # Compile TypeScript
|
|
npm run start # Run compiled server
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|