MCP server

EmailOctopus MCP by usefulapi

io.usefulapi/emailoctopus

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Manage lists, contacts and campaigns, and read campaign performance reports on EmailOctopus.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

13

Token cost

About 2,311 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.emailoctopus]
url = "https://emailoctopus.usefulapi.io/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add emailoctopus https://emailoctopus.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"emailoctopus","server_url":"https://emailoctopus.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"emailoctopus","server_url":"https://emailoctopus.usefulapi.io/mcp"}

Tools

• emailoctopus_create_contact ~305 tokens
  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_create_list ~107 tokens
  CREATES a new list — this MODIFIES live data. Provide a `name`. EmailOctopus: POST /lists. Returns the created list.
• emailoctopus_delete_contact Deletes data · ~186 tokens
  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}.
• emailoctopus_get_campaign ~120 tokens
  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_links_report ~122 tokens
  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_get_campaign_report ~127 tokens
  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_contact ~188 tokens
  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_get_list ~109 tokens
  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_campaigns ~173 tokens
  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_list_contacts ~202 tokens
  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_list_lists ~179 tokens
  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_update_contact ~359 tokens
  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}. Return
• emailoctopus_update_list ~134 tokens
  UPDATES an existing list by id — this MODIFIES live data. Sets the list's `name`. EmailOctopus: PUT /lists/{list_id}. Returns the updated list.

Browse

• Email
• Email marketing

Related MCP servers

• SlickText MCP by usefulapi
  Read SlickText contacts, lists, campaigns, analytics and inbox; create and update contacts.
• Sarbacane MCP by usefulapi
  Read Sarbacane campaigns, stats, lists and blacklists; manage contacts and draft email campaigns.
• iContact MCP by usefulapi
  Read iContact contacts, lists, campaigns and message stats; add contacts and manage subscriptions.
• Sendlane MCP by usefulapi
  Manage Sendlane lists, contacts, tags and custom fields; read campaign and SMS reports.
• GetResponse MCP by usefulapi
  Manage GetResponse contacts, campaigns, newsletters and autoresponders.
• Benchmark Email MCP by usefulapi
  Manage Benchmark Email lists and contacts, and read campaign reports: opens, clicks, bounces.
• Mailchimp MCP by usefulapi
  Read audiences, members, campaigns and reports; add, update, tag and archive subscribers.
• SimpleTexting MCP by usefulapi
  Send SMS/MMS, manage contacts, and read campaigns, messages and media on SimpleTexting.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/emailoctopus.svg)](https://aptlynx.net/servers/io.usefulapi/emailoctopus)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents