
mailbase
io.github.amintt2/mailbase
Email from your agent: transactional sends, campaigns, reply inbox, domains and DNS checks.
Documentation
Mailbase MCP server
Connect Claude, Claude Code, Cursor, Codex, VS Code or any MCP client to Mailbase: send transactional email, run campaigns, read and answer replies, check sending domains, and review prospecting drafts, all from your agent.
https://mailbase.studio/api/mcp/mcp
It is a remote server (Streamable HTTP). There is nothing to install or run: your client connects to the URL above, opens the Mailbase sign-in page, and you pick the workspace and the permissions (read only, write, send) the agent gets. OAuth handles the rest, so no API key is pasted anywhere.
| Resource | URL |
|---|---|
| Streamable HTTP endpoint | https://mailbase.studio/api/mcp/mcp |
| SSE endpoint (older clients) | https://mailbase.studio/api/mcp/sse |
| OAuth metadata | https://mailbase.studio/.well-known/oauth-authorization-server |
| Protected resource metadata | https://mailbase.studio/.well-known/oauth-protected-resource |
Set it up
Claude (claude.ai and Claude Desktop)
- Settings → Connectors → Add custom connector.
- Name it
Mailbase, pastehttps://mailbase.studio/api/mcp/mcp. - Click Connect, sign in to Mailbase, choose the workspace and what Claude may do.
Custom connectors work on every Claude plan.
Claude Code
The MCP server alone:
claude mcp add --transport http mailbase https://mailbase.studio/api/mcp/mcp
Or the full plugin (MCP server, workflow skills and /mailbase:* commands), from inside Claude Code:
/plugin marketplace add amintt2/mailbase-plugins
/plugin install mailbase@mailbase-plugins
/mcp # select "mailbase", sign in, pick a workspace
Cursor
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"mailbase": {
"url": "https://mailbase.studio/api/mcp/mcp"
}
}
}
Then open Cursor Settings → MCP and click Connect next to mailbase.
Codex
codex mcp add mailbase --url https://mailbase.studio/api/mcp/mcp
The ChatGPT / Codex plugin manifest is in plugins/mailbase/plugin.json.
VS Code (GitHub Copilot agent mode)
Add to .vscode/mcp.json:
{
"servers": {
"mailbase": {
"type": "http",
"url": "https://mailbase.studio/api/mcp/mcp"
}
}
}
Any other client
Point it at https://mailbase.studio/api/mcp/mcp with the Streamable HTTP transport.
The client discovers OAuth from the metadata above. Ready-to-copy snippets are in clients/.
What the tools cover
| Area | Examples |
|---|---|
| Sending | Test sends, connect and verify domains, check DNS (check_domain_dns), manage senders, read the deliverability report |
| Campaigns | Create campaigns and templates, preflight, test, schedule or launch, A/B results, stats |
| Inbox | List and read replies, notes, tags, pipeline stages, reply, follow-ups |
| Contacts | Audiences, contacts, suppressions, exports, GDPR erasure |
| Workflows | Create, enroll, pause automation workflows |
| Prospecting | French company register (SIRENE) search, targets, prospect pool, AI drafts you approve one by one |
Two meta tools, search_tools and run_program, let an agent find the right tool
and run read-only multi-step lookups without loading every schema.
Sending stays your decision
- Every tool is annotated: read-only tools are marked read-only, and every tool that emails people or deletes data is marked destructive, so the client asks before running it.
- Launching a campaign or rolling out an A/B winner is refused unless the call confirms it.
- Mailbase applies its own rules to every send, whatever the client: unsubscribed, bounced and complained addresses are skipped, daily caps and domain warm-up hold, and content is screened for scams before anything leaves.
- A connection never does more than the workspace member who approved it.
This repository
| Path | What it is |
|---|---|
server.json | Entry for the official MCP Registry |
clients/ | Config snippets for Claude Code, Codex, Cursor and VS Code |
plugins/mailbase/ | The Mailbase agent plugin: MCP config, skills and slash commands for Claude Code, plus the ChatGPT / Codex manifest |
The Claude Code marketplace you install from is amintt2/mailbase-plugins.
Pricing
Mailbase has a free plan with 200 emails a month and no card. Sending from your own verified domain on the free plan needs a verified card (nothing is charged) and allows 3,000 emails a month. Paid plans, billed yearly: Starter €9/month for 50,000 emails a month, Growth €29/month for 100,000, Scale €79/month for 300,000 (prices excl. VAT). See mailbase.studio/features/transactional-email.
Related
- mailbase-cli: the
mailbasecommand-line client - mailbase-examples:
POST /api/v1/sendin Next.js, Express and Python - email-dns-check: SPF, DKIM, DMARC and MX checks
Docs: MCP OAuth setup · Claude connector · Claude Code plugin. Support: contact@mailbase.studio.
License
MIT for the files in this repository. The Mailbase service itself is hosted at mailbase.studio and is not open source.
No installation packages available.