EmailOctopus MCP Server

Campaigns, segments, sends and reports in your EmailOctopus, worked by your agent.

Hosted MCP Server

npx add-mcp 'https://cotlet.dev/mcp/v1/emailoctopus'

Installs into Claude Code, Codex, Cursor and more

Documentation

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

EmailOctopus API and MCP server: Let your AI agent queue the next EmailOctopus campaign.

EmailOctopus has a public REST API (v2) on every plan, but no official MCP server (checked 27 Oct 2026). Its help center says "We do not support API sending" and that every email has to be created in the Dashboard. Cotlet runs 14 EmailOctopus tools hosted, over MCP for agents and REST for scripts, in your Dashboard login.

Campaigns, segments, sends and reports in your EmailOctopus, worked by your agent. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.

MCP setup REST API guide

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by EmailOctopus. EmailOctopus is a trademark of its owner. If EmailOctopus's own integrations cover what you need, use them first.

What can you automate in EmailOctopus?

  • Start the next issue from the last one
  • Schedule a campaign in your timezone
  • Resend to people who did not open
  • Report last week's opens and clicks
  • List who clicked a given link
  • Unsubscribe contacts gone quiet

Does EmailOctopus have an MCP server or an API?

  • API v2 has 25 operations: lists, contacts, fields, tags, campaign reads, three report types and queuing a contact into an automation. Campaigns are GET only, and segments are not in it at all.
  • The API knows the campaign statuses draft, sending, sent and error. A scheduled campaign has no status of its own there.
  • Zapier has 6 triggers and 5 actions, every action about a contact or a tag. Make adds list create and delete. Neither can touch a campaign.
What you needEmailOctopus API v2ZapierCotlet
Read a campaign report and its clickersYesOpen and click triggersYes
Add, tag or unsubscribe contactsYes, one or a batchOne at a timeUnsubscribe only
Read or create a segmentNoNoYes
Duplicate a campaign, change the subjectNoNoYes
Schedule, unschedule or sendNoNoYes, after your OK
What you set upAn API key and your own codeA Zapier planOne sign-in

Checked 27 Oct 2026. Sources: EmailOctopus API v2 documentation, EmailOctopus Help: API limits, EmailOctopus on Zapier, EmailOctopus on Make, EmailOctopus pricing

How does Cotlet connect to EmailOctopus?

  1. Sign in to EmailOctopus. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

We never keep your EmailOctopus password, and no campaign is scheduled or sent and no contact unsubscribed until you approve it.

Connect EmailOctopus to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Sign in to EmailOctopus in a Cloud Browser. Make a Cotlet account, open EmailOctopus in its Cloud Browser, log in to the Dashboard yourself (Starter or Pro) and press Enable for agents.
  2. Add the Cotlet address. Paste https://cotlet.dev/mcp/v1 into the MCP server or custom connector field of your agent.
  3. Approve the connection. Chat apps send you to a Cotlet sign-in page. Code editors, n8n and scripts take an API key from the console.

One address, https://cotlet.dev/mcp/v1, serves EmailOctopus and every other app you enable. If you enabled EmailOctopus after connecting, refresh the connector and the 14 tools appear.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: emailoctopus_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: emailoctopus_write

How to use the EmailOctopus REST API

Create your Cotlet API key

Create a Cotlet API key with access to EmailOctopus and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Connect EmailOctopus in Cotlet and enable it for agents. Account access: Your own EmailOctopus login. What your agent can do follows your access level: an Analyst can only view reports. You sign in in your own browser and keep your 2-step verification.

Make your first EmailOctopus API request

REST:

curl https://cotlet.dev/api/v1/emailoctopus/lists \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read lists and apply the operation limits

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "emailoctopus",
  "tool": "list_lists",
  "result": {
    "lists": [
      {
        "list_id": "4d1c8e5a-7f2b-4c1e-9a63-0b5d2e8f1a37",
        "name": "Newsletter",
        "subscribed": 4860,
        "pending": 12,
        "unsubscribed": 341
      },
      {
        "list_id": "9b6e2f10-3c5a-4d7e-8f21-a1c4e7d90b52",
        "name": "Workshop waitlist",
        "subscribed": 214,
        "pending": 0,
        "unsubscribed": 9
      }
    ]
  }
}

Returns every list of the account with its list_id, name and the counts of subscribed, pending and unsubscribed contacts. Use list_id as the list_id parameter of the other tools.

Pending contacts are those who have not yet confirmed on a list with double opt-in. Contacts live at list level, so the same email address on two lists is counted on both.

Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.

EmailOctopus workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestContacts of one list with status, tags and dates, filtered by status, tag, segment or email address. Use list_contacts in your configured marketing report.
MakeHTTP > Make a requestCampaigns with status, subject, list, how many contacts they were sent to and open and click rates. Use list_campaigns in your configured marketing report.
Python or Node.jsREST APIReport of one sent campaign: sent, opened, clicked, unsubscribed, bounced and complained, plus links clicked. Use get_campaign_report in your configured marketing report.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads EmailOctopus; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

EmailOctopus API endpoints and MCP tools

Campaigns

A campaign goes to one list; a segment or tag narrows it inside that list and is checked again at send time. The tools never touch the email design, so write it in the editor first.

  • List campaigns (list_campaigns, read): Campaigns with status, subject, list, how many contacts they were sent to and open and click rates.
  • Duplicate campaign (duplicate_campaign, write): Make a draft copy of a campaign, like Duplicate in the Campaigns tab.
  • Update campaign (update_campaign, write): Change the name, subject, preview text or sender of a draft campaign.
  • Set campaign recipients (set_campaign_recipients, write): Choose who a draft campaign goes to: a whole list, a saved segment or a tag.
  • Schedule campaign (schedule_campaign, write, asks first): Schedule a draft campaign for a date, time and timezone.
  • Unschedule campaign (unschedule_campaign, write): Stop a scheduled campaign from sending, like Unschedule in the Campaigns tab.
  • Send campaign (send_campaign, write, asks first): Send a draft campaign right away.

Reports

Reports show up minutes after a send, sometimes a couple of hours. On Starter they disappear after 30 days, on Pro they stay.

  • Get campaign report (get_campaign_report, read): Report of one sent campaign: sent, opened, clicked, unsubscribed, bounced and complained, plus links clicked.
  • List campaign activity (list_campaign_activity, read): Contacts who opened, clicked, unsubscribed, bounced or complained on a campaign, or did not open or click.

Lists, contacts and segments

Contacts live per list, so the same address on two lists counts twice. Clean-up marks contacts unsubscribed and never deletes, which keeps their opens and clicks.

  • List lists (list_lists, read): Lists of your EmailOctopus account with their subscribed, pending and unsubscribed counts.
  • List contacts (list_contacts, read): Contacts of one list with status, tags and dates, filtered by status, tag, segment or email address.
  • List segments (list_segments, read): Saved segments of a list with the conditions each one is built from.
  • Create segment (create_segment, write): Create a reusable segment on a list from conditions on tags, fields, dates, source or campaign and contact activity.
  • Unsubscribe contacts (unsubscribe_contacts, write, asks first): Mark contacts as unsubscribed in bulk, by segment, tag or email addresses.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/emailoctopus-api-mcp-server#tools

Who can see my EmailOctopus session, and how do I revoke it?

  • What we store. Your signed-in EmailOctopus profile, AES-256-GCM encrypted, in Finland. No password.
  • What your agent gets. The 14 EmailOctopus tools, never the session cookie or an API key.
  • What the session sees. What your login sees: lists, contact emails and fields, campaigns, reports.
  • What no tool touches. Billing, plan, users, API keys, automations, deletes.
  • If EmailOctopus logs you out. You log in again yourself, in the same Cloud Browser.
  • How to cut access. Disable for agents, reset the browser, or change your EmailOctopus password.

Your contacts' email addresses pass through the agent when it lists clickers or inactive contacts, the same way an export would. EmailOctopus treats any tool you connect as your processor, not theirs (Terms 10.2), so it sits on your side of your privacy notice. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Approvals, undo and mistakes

  1. Reads the first send. Stops if the report is not ready yet.
  2. Builds the segment. Did not open, plus was sent, so outsiders stay out.
  3. Copies the campaign. New subject, same design, still a draft.
  4. Waits for your OK. The schedule shows up in your Cotlet console first.
ActionUndo
Duplicate or update a draftYes, edit it again or delete the draft in the Dashboard
Create a segmentDelete it in the Dashboard; it emailed no one
Schedule a campaignYes, unschedule_campaign before the send time
Send a campaignNo, it cannot be recalled once sending starts
Unsubscribe contactsNot through an import; treat it as one-way

3 of 14 tools ask first: schedule_campaign, send_campaign and unsubscribe_contacts. A draft, a new subject, a segment or an unschedule reaches nobody, so those run at once. You can switch the wait off per tool, for example for a weekly schedule you already trust.

On a new EmailOctopus account the first campaign may sit "under review" for a few minutes while EmailOctopus checks it for spam. A scheduled send can start late for that reason, not because of the tool.

MCP call:

{
  "name": "schedule_campaign",
  "arguments": {
    "campaign_id": "d5e8a3b1-62c9-4e70-8a14-9f0b7c2d6e83",
    "date": "2026-10-22",
    "time": "09:00",
    "timezone": "Europe/London"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/emailoctopus/campaigns/d5e8a3b1-62c9-4e70-8a14-9f0b7c2d6e83/schedule \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-10-22","time":"09:00","timezone":"Europe/London"}'

Response:

{
  "campaign_id": "d5e8a3b1-62c9-4e70-8a14-9f0b7c2d6e83",
  "name": "Autumn offer, last chance",
  "status": "scheduled",
  "scheduled_for": "2026-10-22T09:00:00+01:00",
  "timezone": "Europe/London"
}

A cron job or an n8n flow can call the same tools over REST at /api/v1/emailoctopus with the same key and price, for example a Monday report of last week's campaigns posted to Slack. Scheduling a campaign with no recipients or no design fails, and failed calls are free. Each tool row above shows its REST path.

How much does the EmailOctopus MCP server cost?

About $12 a month for a weekly newsletter with 5,000 subscribers, 2,110 credits. Your EmailOctopus plan stays as it is.

JobCallsCredits
Next issue copied from last week's, scheduled5 × 4200
Monday report with the best click rate3 × 4120
Who clicked the main link3 × 4120
Resend to non-openers6 × 2120
Unsubscribe contacts inactive 90 days5 × 150
Cloud Browser, 30 days1,500
Total2,110
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Works on the free Starter plan and on Pro

EmailOctopus publishes no typical list size, and reviews describe its usual sender as a weekly list of 500 to 2,500, so the month is our example. For scale, EmailOctopus Pro for 5,000 subscribers is $31.50 a month on monthly billing (Listlift, 23 Sep 2026). Dollars at the $29 pack rate.

EmailOctopus MCP server on GitHub, Zapier or hosted: which to use

OptionWhat it doesWhere it stops
OfirOhan/emailoctopus-mcp13 tools on API v2: lists, contacts, campaign reports, who opened or clicked, queuing a contact into an automation. MIT, 0 stars.No drafts, segments or schedules. You build it with npm and keep an API key in your client config. One commit, 4 Oct 2026.
Composio20 hosted tools for contacts, fields, lists and tags, plus recent campaigns. Free tier of 100,000 calls a month.No campaign writes and no reports beyond the campaign list.
Pipedream MCPHosted actions from Pipedream's EmailOctopus components.Same API, same gaps.
Zapier5 contact and tag actions, open, click and bounce triggers.Nothing for campaigns or segments.

If your agent only needs to add subscribers, tag them or read a report, take a free API option above and keep your API key to yourself. When the job is the send itself, from a copied draft to a resend for non-openers, Cotlet works in the Dashboard where EmailOctopus says campaigns are made.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), in business since 2019, led by its founders Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the EmailOctopus tools go to contact@cotlet.dev.

EmailOctopus API and MCP: questions

How do I get access?

Sign up free at https://cotlet.dev, open EmailOctopus under Integrations in the console and log in to EmailOctopus in its Cloud Browser. The trial starts when you sign up and asks for no card.

How do I connect EmailOctopus to ChatGPT or Claude?

Sign up at cotlet.dev, log in to EmailOctopus once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your EmailOctopus account through Cotlet, in their phone apps too.

What can ChatGPT do in EmailOctopus?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in EmailOctopus: resend a campaign to non-openers; unsubscribe inactive contacts; schedule the next newsletter from the last one. You ask in plain words, and anything that reaches other people waits for your OK first.

Which EmailOctopus plan or access level does my agent need?

Cotlet works in the account you sign in with, so your plan and access level still apply. Extra users with their own access level (Admin, Manager, Analyst, Accountant) are a Pro feature, and an Analyst can only view reports. On the free Starter plan reports stay for 30 days and a list can have 10 tags, against 50 on Pro (EmailOctopus Help: Invite users to your account, Using tags, pricing page).

Can my agent write or design the email?

No. The tools set the name, subject, preview text, sender, recipients and sending time of a campaign, and duplicate_campaign copies a campaign you already designed. The design itself stays in the drag and drop editor or your own HTML, because EmailOctopus has no API for creating emails and says they are created in the Dashboard (EmailOctopus Help: API limits).

Can I use my EmailOctopus API key instead of logging in?

No. An API key reaches only what API v2 offers, and the jobs on this page are the ones it does not offer. Cotlet works in your Dashboard session, and the API key stays yours for scripts of your own.

Does it work on the free Starter plan?

Yes, within Starter's limits: 2,500 subscribers, 10,000 emails a month, reports for 30 days and EmailOctopus branding on emails.

Can it react when someone subscribes or clicks?

Cotlet has no EmailOctopus trigger. Run your agent on a schedule, or let an EmailOctopus webhook or a Zapier trigger such as Email Clicked start it.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 14 tools, inputs, answers, API key and price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with EmailOctopus?

No. Cotlet is independent and not affiliated with EmailOctopus or Three Hearts Digital Ltd.

Can I use the EmailOctopus API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.