Instantly MCP Server

A streamlined MCP server for Instantly.ai v2 API integration. Enables AI assistants to manage email campaigns, accounts, leads, and analytics through Instantly's platform.

Key Features

Campaign Management: Create, update, and manage email campaigns
Account Management: Handle sending accounts and warmup settings
Lead Management: Organize and manage your lead database
Analytics: Track campaign performance and metrics
Email Operations: Send emails and verify addresses
API Integration: Full access to Instantly.ai v2 API endpoints

Overview

The Instantly MCP Server brings Instantly.ai's email automation capabilities directly into Claude and other AI assistants. This enables AI-powered management of:

Email campaigns and automation
Account management and warmup
Analytics and performance tracking
Lead management and segmentation
Email sending and verification
API key management

Perfect for sales teams, marketers, and developers who want to integrate email automation into their AI workflows.

Quick Start

Using with npx (no installation required)

Add to your MCP settings configuration:

{
  "mcpServers": {
    "instantly": {
      "command": "npx",
      "args": ["instantly-mcp", "--api-key", "YOUR_INSTANTLY_API_KEY"]
    }
  }
}

Local Installation

Clone and install:

npm install
npm run build

Add to your MCP settings:

{
  "mcpServers": {
    "instantly": {
      "command": "node",
      "args": ["/path/to/instantly-mcp/dist/index.js", "--api-key", "YOUR_INSTANTLY_API_KEY"]
    }
  }
}

Getting Your API Key

Log in to Instantly.ai
Navigate to Settings > Integrations > API
Generate or copy your API key

Available Tools

Campaign Management

list_campaigns - List all campaigns with optional filters and pagination
get_campaign - Get details of a specific campaign
create_campaign - Create new email campaigns
update_campaign - Update an existing campaign
activate_campaign - Activate a campaign

Analytics

get_campaign_analytics - Get analytics for campaigns
get_campaign_analytics_overview - Get analytics overview for all campaigns

Account Management

list_accounts - List sending accounts
create_account - Create a new sending account
update_account - Update a sending account
get_warmup_analytics - Get warmup analytics for an account

Lead Management

list_leads - List leads with filters and pagination
create_lead - Create a new lead
update_lead - Update a lead
move_leads - Move leads between campaigns or lists

Lead Lists

list_lead_lists - List all lead lists with pagination
create_lead_list - Create a new lead list

Email Operations

send_email - Send a single email
list_emails - List emails with filters and pagination

Email Verification

verify_email - Verify if an email address is valid

API Key Management

list_api_keys - List all API keys
create_api_key - Create a new API key

Example Usage

Once configured, you can use natural language to interact with Instantly:

"Create a new email campaign for Q2 outreach"
"List all my active campaigns"
"Show me the analytics for campaign XYZ"
"List all my sending accounts"
"Check which accounts I can use for campaigns"
"Create a new lead list for prospects"

Development

# Install dependencies
npm install

# Run in development mode
npm run dev -- --api-key YOUR_API_KEY

# Build for production
npm run build

Testing

Local Testing

Test the API endpoints directly:

# Install dependencies
npm install

# Run the test script
tsx test-endpoints.ts --api-key YOUR_API_KEY

Test with MCP Inspector:

# Build the project
npm run build

# Test with MCP Inspector
npx @modelcontextprotocol/inspector dist/index.js -- --api-key YOUR_API_KEY

Test with Claude Desktop: Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "instantly": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Endpoint Documentation

The MCP server includes all major Instantly v2 API endpoints:

Campaigns: Create, list, update, activate campaigns
Analytics: Get campaign analytics and overview
Accounts: Manage sending accounts and warmup
Leads: Create, list, update, move leads
Lead Lists: Create and manage lead lists
Emails: Send emails and list email history
Email Verification: Verify email addresses
API Keys: Manage API keys

For full API documentation, visit: https://developer.instantly.ai/

License

MIT

Features

Full Instantly v2 API coverage
Campaign creation and management
Complete pagination support for all list endpoints
Rate limiting with informative messages
Comprehensive error handling
TypeScript support
Secure API key handling
Example scripts included

Recent Updates

v1.0.0 (Latest) - Initial Release

Full Instantly v2 API integration
Campaign management capabilities
Account and lead management
Analytics and reporting
Email operations and verification
Comprehensive error handling and validation

See CHANGELOG.md for complete version history.

Known Issues

Campaign creation may require specific account configuration
Some endpoints return empty results despite data existing (working on fixes)
Email sending requires verified sender accounts

Contributing

Pull requests are welcome! Please ensure all tests pass and follow the existing code style.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Support

Issues: GitHub Issues
Documentation: Instantly API Docs
MCP Protocol: Model Context Protocol

Publishing

This package is automatically published to npm when a new version tag is pushed:

npm version patch|minor|major
git push --tags

Changelog

See CHANGELOG.md for a list of changes.

Author

Created by bcharleson

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides access to Instantly API v2 for email campaign and lead management functionality.

Related MCP Servers

Gmail MCP Server
Quantum-369
-
security
A
license
-
quality
Enables interaction with Gmail through the Gmail API to read, send, and manage emails. Supports multiple Gmail accounts with real-time monitoring and advanced features for email search and attachment handling.
Last updated -
13
Python
Apache 2.0
SendGrid MCP Server
Garoth
A
security
F
license
A
quality
Provides an interface to manage email marketing, contact lists, dynamic templates, and email analytics via SendGrid's API.
Last updated -
21
17
TypeScript
Mailtrap Email Sending
railsware
A
security
A
license
A
quality
Integrates with Mailtrap Email Platform to enable sending transactional emails via API.
Last updated -
1
594
42
TypeScript
MIT License
Smartlead Simplified MCP Server
jonathan-politzki
A
security
F
license
A
quality
A Multi-Channel Proxy server that provides a structured interface for interacting with Smartlead's API, organizing functionality into logical tools for campaign management, lead management, and other marketing automation features.
Last updated -
20
17
15
TypeScript

View all related MCP servers

Appeared in Searches

Using Instantly AI for Automation and Productivity