Mcp Server
openses-email/mcp-server
OpenSES email on your own Amazon SES: shared inbox, sending, delivery status, contacts, sequences.
- tools
- 28
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 2
- last updated
- Nov 13, 2026
Tools
28 toolsPublic tool metadata for what this MCP can expose to an agent.
inboxes_listThe account's inboxes with unread counts
The account's inboxes with unread counts
No parameter schema in public metadata yet.
inbox_threadsConversations, filtered by inbox, unread, archived or text, with paging
Conversations, filtered by inbox, unread, archived or text, with paging
No parameter schema in public metadata yet.
inbox_readA conversation with quoted history folded away and delivery status for sent messages
A conversation with quoted history folded away and delivery status for sent messages
No parameter schema in public metadata yet.
inbox_replyAnswer a conversation, or start one from an inbox
Answer a conversation, or start one from an inbox
No parameter schema in public metadata yet.
inbox_composeAnswer a conversation, or start one from an inbox
Answer a conversation, or start one from an inbox
No parameter schema in public metadata yet.
inbox_updateMark read or unread, archive, label
Mark read or unread, archive, label
No parameter schema in public metadata yet.
inbox_attachmentA 10-minute download link for an attachment
A 10-minute download link for an attachment
No parameter schema in public metadata yet.
emails_sendSend now or scheduled, with templates, tags and an idempotency key
Send now or scheduled, with templates, tags and an idempotency key
No parameter schema in public metadata yet.
emails_searchFind sent email and its full delivery timeline
Find sent email and its full delivery timeline
No parameter schema in public metadata yet.
emails_getFind sent email and its full delivery timeline
Find sent email and its full delivery timeline
No parameter schema in public metadata yet.
emails_cancelCancel a scheduled email
Cancel a scheduled email
No parameter schema in public metadata yet.
account_healthSES quota, sandbox state, bounce and complaint rates per region
SES quota, sandbox state, bounce and complaint rates per region
No parameter schema in public metadata yet.
domains_statusDomain verification and the DNS records each domain needs
Domain verification and the DNS records each domain needs
No parameter schema in public metadata yet.
suppressions_listThe account-wide do-not-send list
The account-wide do-not-send list
No parameter schema in public metadata yet.
suppressions_addThe account-wide do-not-send list
The account-wide do-not-send list
No parameter schema in public metadata yet.
suppressions_removeThe account-wide do-not-send list
The account-wide do-not-send list
No parameter schema in public metadata yet.
contacts_searchContacts and consent
Contacts and consent
No parameter schema in public metadata yet.
contacts_upsertContacts and consent
Contacts and consent
No parameter schema in public metadata yet.
contacts_unsubscribeContacts and consent
Contacts and consent
No parameter schema in public metadata yet.
contacts_deleteContacts and consent
Contacts and consent
No parameter schema in public metadata yet.
topics_listSubscription topics with subscriber counts
Subscription topics with subscriber counts
No parameter schema in public metadata yet.
sequences_listDrip and sales sequences
Drip and sales sequences
No parameter schema in public metadata yet.
sequences_enrollDrip and sales sequences
Drip and sales sequences
No parameter schema in public metadata yet.
sequences_stopDrip and sales sequences
Drip and sales sequences
No parameter schema in public metadata yet.
templates_listSaved templates
Saved templates
No parameter schema in public metadata yet.
templates_getSaved templates
Saved templates
No parameter schema in public metadata yet.
templates_upsertSaved templates
Saved templates
No parameter schema in public metadata yet.
broadcasts_listBroadcasts and their results
Broadcasts and their results
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
OPENSES_API_KEYsecretOptional API key from the OpenSES dashboard. Without it, sign-in opens in the browser.
OPENSES_API_URLOptional base URL of a self-hosted OpenSES API.
Readme
OpenSES MCP
Connect Claude, ChatGPT, Cursor and other AI assistants to OpenSES, the open-source email platform that runs on your own Amazon SES. Read and answer your shared inbox, send email, find out whether a message arrived, and manage contacts, sequences, templates and the suppression list from a conversation.
Website · Docs · Agent skill · npm
Two ways to connect
Remote (recommended). Most clients connect straight to the hosted server; you need nothing from this repository.
https://api.openses.email/mcp
Add it as a custom connector (Claude, ChatGPT) or an MCP server (Cursor, VS Code, Claude Code: claude mcp add --transport http openses https://api.openses.email/mcp). Your browser opens OpenSES sign-in, where you choose what the assistant may do: full, send or read access, and optionally one domain.
Local stdio (this package). For clients that only run local MCP servers, Node.js 22 or newer:
Details
- Repository
- github.com/openses-email/mcp-server
- Category
- Communication & Messaging
- Package
openses-mcp- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
