How do I install the instantly mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

The recorded environment keys are `INSTANTLY_API_KEY`, `TOOL_CATEGORIES`. Keep credentials outside committed files and confirm the configuration required by your installed version.

SSyncDev

Start a project

Instantly MCP Server

A lightweight, robust Model Context Protocol (MCP) server for the **Instantly.ai V2 API**, built with FastMCP.

Local serverstdioPython

What is the Instantly MCP Server?

A lightweight, robust Model Context Protocol (MCP) server for the Instantly.ai V2 API, built with FastMCP.

The short version

38 tools — across 6 categories (accounts, campaigns, leads, emails, analytics, background_jobs)
Dual transport support — HTTP (remote deployment) + stdio (local)
Lazy loading — Reduce context window by loading only specific tool categories
Multi-tenant support — Per-request API keys for HTTP deployments
Comprehensive error handling — Detailed, actionable error messages
Rate limiting — Automatic tracking from API response headers

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
list_accounts	List email accounts with filtering
get_account	Get account details and warmup status
create_account	Create account with IMAP/SMTP credentials
update_account	Update account settings
manage_account_state	Pause, resume, warmup control, test vitals
delete_account	⚠️ Permanently delete account
create_campaign	Create email campaign (two-step process)
list_campaigns	List campaigns with pagination
get_campaign	Get campaign details and sequences
update_campaign	Update campaign settings
activate_campaign	Start campaign sending
pause_campaign	Stop campaign sending
delete_campaign	⚠️ Permanently delete campaign
search_campaigns_by_contact	Find campaigns a contact is enrolled in
list_leads	List leads with filtering
get_lead	Get lead details
create_lead	Create single lead
update_lead	Update lead (⚠️ custom_variables replaces all)
list_lead_lists	List lead lists
create_lead_list	Create lead list
update_lead_list	Update lead list
get_verification_stats_for_lead_list	Get email verification stats
add_leads_to_campaign_or_list_bulk	Bulk add up to 1,000 leads
delete_lead	⚠️ Permanently delete lead
delete_lead_list	⚠️ Permanently delete lead list
move_leads_to_campaign_or_list	Move/copy leads between campaigns/lists
list_emails	List emails with filtering
get_email	Get email details
reply_to_email	🚨 Send real email reply
count_unread_emails	Count unread inbox emails
verify_email	Verify email deliverability
mark_thread_as_read	Mark email thread as read
get_campaign_analytics	Campaign metrics (opens, clicks, replies)
get_daily_campaign_analytics	Day-by-day performance
get_warmup_analytics	Account warmup metrics
list_background_jobs	List async background jobs with pagination
get_background_job	Get details of a specific background job

How to install the Instantly MCP Server

{
  "mcpServers": {
    "instantly": {
      "command": "python",
      "args": [
        "-m",
        "instantly_mcp.server"
      ],
      "env": {
        "INSTANTLY_API_KEY": "YOUR_INSTANTLY_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
INSTANTLY_API_KEY	Declared in the maintainer’s client configuration.	Yes

Example prompts to try

“Use Instantly MCP to list accounts.”
“Use Instantly MCP to get account.”
“Use Instantly MCP to create account.”

Frequently asked questions

A lightweight, robust Model Context Protocol (MCP) server for the **Instantly.ai V2 API**, built with FastMCP. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.