Skip to main content
The Ecomail MCP server lets you manage lists, subscribers, campaigns, automations, transactional emails, e-commerce transactions, templates, domains, and more — directly from any MCP-compatible client like Claude Desktop, Cursor, or Claude Code.

​
Setup

Before you start, obtain your API key:
  1. Log in to your Ecomail account
  2. Go to Manage your account → For developers
  3. Click Copy API Key

​
Claude Code

claude mcp add ecomail -e ECOMAIL_API_KEY=your_api_key -- npx -y ecomail-mcp

​
Cursor

Open the command palette and choose Cursor Settings > MCP > Add new global MCP server. 
{
  "mcpServers": {
    "ecomail": {
      "command": "npx",
      "args": ["-y", "ecomail-mcp"],
      "env": {
        "ECOMAIL_API_KEY": "your_api_key"
      }
    }
  }
}

​
Claude Desktop

Open Claude Desktop settings > Developer tab > Edit Config. 
{
  "mcpServers": {
    "ecomail": {
      "command": "npx",
      "args": ["-y", "ecomail-mcp"],
      "env": {
        "ECOMAIL_API_KEY": "your_api_key"
      }
    }
  }
}

​
Options

OptionDescription
ECOMAIL_API_KEYYour Ecomail API key (environment variable, required)
--keyYour Ecomail API key (CLI argument, alternative to env var)

​
Available tools

The MCP server exposes all Ecomail API endpoints as tools:
CategoryTools
Automationslist-automations, trigger-automation, get-automation-stats, get-automation-stats-detail, get-automation-stats-emails
Campaignslist-campaigns, create-campaign, get-campaign, update-campaign, send-campaign, get-campaign-stats, get-campaign-stats-detail, get-segment-stats
Discount couponsimport-coupons, delete-coupons
Domainslist-domains, create-domain, delete-domain
Feedsrefresh-product-feed, refresh-data-feed
Listslist-lists, create-list, get-list, update-list, get-subscribers, get-subscriber-from-list, get-subscriber-by-phone, subscribe, subscribe-bulk, unsubscribe, update-subscriber, get-segments
Subscribersget-subscriber, delete-subscriber, find-contact
Templatescreate-template, get-template
Tracker eventscreate-event
Transactional emailssend-transactional-email, send-transactional-template, get-transactional-stats, get-doi-stats
Transactionscreate-transaction, create-bulk-transactions, get-transactions, update-transaction, delete-transaction, delete-bulk-transactions
Webhooksset-webhook-url, get-webhook-url, delete-webhook-url