# 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