Skip to content
MCP server

EmailOctopus MCP by usefulapi

Hosted MCP server to manage EmailOctopus lists, contacts and campaign reports from AI

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.40.4
Listing updated
1 day ago

Similar MCP servers

About EmailOctopus MCP by usefulapi

EmailOctopus MCP by usefulapi is a freemium MCP server for marketing and seo. It runs as a hosted remote server, so there is nothing to install locally.

The server gives Claude, ChatGPT, Cursor and other MCP clients direct access to an EmailOctopus account. Once connected, an assistant can look up lists and their contact counts, read contacts with their tags and status, and pull campaign reports covering sent, opened, clicked, bounced and unsubscribed figures. A per-link click report shows which URLs in a campaign drew the most clicks.

Access is handled through OAuth: the login page asks for an EmailOctopus API key, and the server calls the EmailOctopus API on the user's behalf. Five of the 17 tools can create or change data, including adding, updating or permanently deleting contacts and creating or renaming lists, so clients that ask for approval before a tool runs are the safer choice for those actions.

The server suits newsletter owners and email marketers who want to check campaign results or manage subscribers through a chat assistant instead of the EmailOctopus dashboard. It is an independent service from usefulapi and is not affiliated with EmailOctopus.

Install

Run in a terminal

claude mcp add --transport http emailoctopus https://emailoctopus.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://emailoctopus.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "emailoctopus": {
      "url": "https://emailoctopus.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "emailoctopus": {
      "type": "http",
      "url": "https://emailoctopus.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "emailoctopus": {
      "serverUrl": "https://emailoctopus.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "emailoctopus": {
      "type": "http",
      "url": "https://emailoctopus.usefulapi.io/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (13)

Read directly from the server.

emailoctopus_list_lists
List all lists in the account. Returns {data:[...],paging:{...}} — each list's id, name, contact counts by status, and created_at. Paginate with `limit` (max 100) and `starting_after` (cursor from the previous page). EmailOctopus: GET /lists.
emailoctopus_get_list
Get a single list by its id. Returns the list's full state — name, contact counts by status, and created_at. EmailOctopus: GET /lists/{list_id}.
emailoctopus_list_contacts
List the contacts in a list. Returns {data:[...],paging:{...}} — each contact's id, email_address, fields, tags, status, and created_at. Paginate with `limit` (max 100) and `starting_after`. EmailOctopus: GET /lists/{list_id}/contacts.
emailoctopus_get_contact
Get a single contact in a list. Returns email_address, fields, tags, status, and created_at. `contact_id` is the MD5 hash of the lowercased email address, or the `id` returned by emailoctopus_list_contacts. EmailOctopus: GET /lists/{list_id}/contacts/{contact_id}.
emailoctopus_list_campaigns
List all campaigns in the account. Returns {data:[...],paging:{...}} — each campaign's id, name, status, subject, and created_at. Paginate with `limit` (max 100) and `starting_after`. EmailOctopus: GET /campaigns.
emailoctopus_get_campaign
Get a single campaign by its id. Returns the campaign's full state — name, status, subject, from, content, and created_at. EmailOctopus: GET /campaigns/{campaign_id}.
emailoctopus_get_campaign_report
Get a campaign's aggregate performance report — sent, opened, clicked, bounced, unsubscribed, complained, and related counts. EmailOctopus: GET /campaigns/{campaign_id}/reports/summary.
emailoctopus_get_campaign_links_report
Get a campaign's per-link click report — for each link in the campaign, the URL and its click counts. EmailOctopus: GET /campaigns/{campaign_id}/reports/links.
emailoctopus_create_list
CREATES a new list — this MODIFIES live data. Provide a `name`. EmailOctopus: POST /lists. Returns the created list.
emailoctopus_update_list
UPDATES an existing list by id — this MODIFIES live data. Sets the list's `name`. EmailOctopus: PUT /lists/{list_id}. Returns the updated list.
emailoctopus_create_contact
CREATES a new contact in a list — this MODIFIES live data (adds a subscriber). `email_address` is required; optionally set `fields` (keyed by field tag), `tags`, and `status`. EmailOctopus: POST /lists/{list_id}/contacts. Returns the created contact.
emailoctopus_update_contact
UPDATES an existing contact in a list — this MODIFIES live data. Send only the fields you want to change (email_address, fields, tags, status). `contact_id` is the MD5 hash of the lowercased email address, or the id from list_contacts. EmailOctopus: PUT /lists/{list_id}/contacts/{contact_id}. Returns the updated contact.
emailoctopus_delete_contact
PERMANENTLY REMOVES a contact from a list — this MODIFIES live data and cannot be undone. `contact_id` is the MD5 hash of the lowercased email address, or the id from list_contacts. EmailOctopus: DELETE /lists/{list_id}/contacts/{contact_id}.

What it does

Campaign performance reports
Returns sent, opened, clicked, bounced, unsubscribed and complained counts for a campaign.
Per-link click breakdown
Ranks the links in a campaign by how many clicks each received.
List and contact overview
Lists audiences with contact counts by status and reads contacts with their fields and tags.
Subscriber management
Adds, updates or deletes contacts in a list, with the delete action marked as irreversible.
List creation and renaming
Creates new lists and renames existing ones without opening the dashboard.
Usage metering and plan changes
Reports tool-call usage and handles upgrading or cancelling a paid plan through the AI client.

Good for

  • Compare open and click rates across recent newsletter campaigns
  • Check which article links readers clicked most in the last send
  • Count subscribers on each list before planning a send
  • Add a new signup to a newsletter list from a chat prompt
  • Set up a new audience list for an upcoming campaign

Pricing

Freemium, from $9 a month

Free plan with 50 tool calls/month; Pro from $9/mo; Pro+ $39/mo.

Prices change. Check usefulapi.io before you buy.

EmailOctopus MCP by usefulapi FAQ

Is this an official EmailOctopus product?

No. usefulapi is an independent service and is not affiliated with or endorsed by EmailOctopus.

Do I need to put my API key in the client config?

No. Add only the server URL. The server uses OAuth, and the login page asks for your EmailOctopus API key. The README and setup page advise removing any Authorization header from the config.

Can the AI change my EmailOctopus data?

Yes, five tools can create or modify data, including deleting a contact, which cannot be undone. Most MCP clients ask for approval before a tool call runs.

What does it cost?

The free plan allows 50 tool calls a month. Pro costs $9 per month or $90 per year for 10,000 calls, and Pro+ costs $39 per month or $390 per year for 100,000 calls. Each subscription covers this server only.

Is EmailOctopus MCP by usefulapi free?

EmailOctopus MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

How do I add EmailOctopus MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http emailoctopus https://emailoctopus.usefulapi.io/mcp

What are the best alternatives to EmailOctopus MCP by usefulapi?

The closest alternatives to EmailOctopus MCP by usefulapi are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Snapchat Ads MCP Server, MCP and Red Center Studio free tools.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers