Skip to content
Back to search

mailbase-mcp

Remote MCP server for Mailbase: send email, run campaigns and triage replies from Claude, Cursor, Codex or VS Code. OAuth, no API key.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/amintt2--mailbase-mcp/badge.svg)](/listings/amintt2--mailbase-mcp)

HTML

<a href="/listings/amintt2--mailbase-mcp"><img src="/api/listings/amintt2--mailbase-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 150 lines
  1. # Mailbase MCP server
  2. Connect Claude, Claude Code, Cursor, Codex, VS Code or any MCP client to
  3. [Mailbase](https://mailbase.studio): send transactional email, run campaigns,
  4. read and answer replies, check sending domains, and review prospecting drafts,
  5. all from your agent.
  6. ```
  7. https://mailbase.studio/api/mcp/mcp
  8. ```
  9. It is a **remote** server (Streamable HTTP). There is nothing to install or run:
  10. your client connects to the URL above, opens the Mailbase sign-in page, and
  11. you pick the workspace and the permissions (read only, write, send) the agent
  12. gets. OAuth handles the rest, so no API key is pasted anywhere.
  13. | Resource | URL |
  14. | --- | --- |
  15. | Streamable HTTP endpoint | `https://mailbase.studio/api/mcp/mcp` |
  16. | SSE endpoint (older clients) | `https://mailbase.studio/api/mcp/sse` |
  17. | OAuth metadata | `https://mailbase.studio/.well-known/oauth-authorization-server` |
  18. | Protected resource metadata | `https://mailbase.studio/.well-known/oauth-protected-resource` |
  19. ## Set it up
  20. ### Claude (claude.ai and Claude Desktop)
  21. 1. Settings → Connectors → **Add custom connector**.
  22. 2. Name it `Mailbase`, paste `https://mailbase.studio/api/mcp/mcp`.
  23. 3. Click **Connect**, sign in to Mailbase, choose the workspace and what Claude may do.
  24. Custom connectors work on every Claude plan.
  25. ### Claude Code
  26. The MCP server alone:
  27. ```sh
  28. claude mcp add --transport http mailbase https://mailbase.studio/api/mcp/mcp
  29. ```
  30. Or the full plugin (MCP server, workflow skills and `/mailbase:*` commands), from inside Claude Code:
  31. ```
  32. /plugin marketplace add amintt2/mailbase-plugins
  33. /plugin install mailbase@mailbase-plugins
  34. /mcp # select "mailbase", sign in, pick a workspace
  35. ```
  36. ### Cursor
  37. Add to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
  38. ```json
  39. {
  40. "mcpServers": {
  41. "mailbase": {
  42. "url": "https://mailbase.studio/api/mcp/mcp"
  43. }
  44. }
  45. }
  46. ```
  47. Then open Cursor Settings → MCP and click **Connect** next to `mailbase`.
  48. ### Codex
  49. ```sh
  50. codex mcp add mailbase --url https://mailbase.studio/api/mcp/mcp
  51. ```
  52. The ChatGPT / Codex plugin manifest is in [`plugins/mailbase/plugin.json`](plugins/mailbase/plugin.json).
  53. ### VS Code (GitHub Copilot agent mode)
  54. Add to `.vscode/mcp.json`:
  55. ```json
  56. {
  57. "servers": {
  58. "mailbase": {
  59. "type": "http",
  60. "url": "https://mailbase.studio/api/mcp/mcp"
  61. }
  62. }
  63. }
  64. ```
  65. ### Any other client
  66. Point it at `https://mailbase.studio/api/mcp/mcp` with the Streamable HTTP transport.
  67. The client discovers OAuth from the metadata above. Ready-to-copy snippets are in [`clients/`](clients/).
  68. ## What the tools cover
  69. | Area | Examples |
  70. | --- | --- |
  71. | Sending | Test sends, connect and verify domains, check DNS (`check_domain_dns`), manage senders, read the deliverability report |
  72. | Campaigns | Create campaigns and templates, preflight, test, schedule or launch, A/B results, stats |
  73. | Inbox | List and read replies, notes, tags, pipeline stages, reply, follow-ups |
  74. | Contacts | Audiences, contacts, suppressions, exports, GDPR erasure |
  75. | Workflows | Create, enroll, pause automation workflows |
  76. | Prospecting | French company register (SIRENE) search, targets, prospect pool, AI drafts you approve one by one |
  77. Two meta tools, `search_tools` and `run_program`, let an agent find the right tool
  78. and run read-only multi-step lookups without loading every schema.
  79. ## Sending stays your decision
  80. - Every tool is annotated: read-only tools are marked read-only, and every tool that
  81. emails people or deletes data is marked destructive, so the client asks before running it.
  82. - Launching a campaign or rolling out an A/B winner is refused unless the call confirms it.
  83. - Mailbase applies its own rules to every send, whatever the client: unsubscribed, bounced
  84. and complained addresses are skipped, daily caps and domain warm-up hold, and content is
  85. screened for scams before anything leaves.
  86. - A connection never does more than the workspace member who approved it.
  87. ## This repository
  88. | Path | What it is |
  89. | --- | --- |
  90. | [`server.json`](server.json) | Entry for the [official MCP Registry](https://registry.modelcontextprotocol.io) |
  91. | [`clients/`](clients/) | Config snippets for Claude Code, Codex, Cursor and VS Code |
  92. | [`plugins/mailbase/`](plugins/mailbase/) | The Mailbase agent plugin: MCP config, skills and slash commands for Claude Code, plus the ChatGPT / Codex manifest |
  93. The Claude Code marketplace you install from is [amintt2/mailbase-plugins](https://github.com/amintt2/mailbase-plugins).
  94. ## Pricing
  95. Mailbase has a free plan with 200 emails a month and no card. Sending from your own
  96. verified domain on the free plan needs a verified card (nothing is charged) and allows
  97. 3,000 emails a month. Paid plans, billed yearly: Starter €9/month for 50,000 emails a
  98. month, Growth €29/month for 100,000, Scale €79/month for 300,000 (prices excl. VAT).
  99. See [mailbase.studio/features/transactional-email](https://mailbase.studio/features/transactional-email).
  100. ## Related
  101. - [mailbase-cli](https://github.com/amintt2/mailbase-cli): the `mailbase` command-line client
  102. - [mailbase-examples](https://github.com/amintt2/mailbase-examples): `POST /api/v1/send` in Next.js, Express and Python
  103. - [email-dns-check](https://github.com/amintt2/email-dns-check): SPF, DKIM, DMARC and MX checks
  104. Docs: [MCP OAuth setup](https://mailbase.studio/docs/mcp-oauth) ·
  105. [Claude connector](https://mailbase.studio/docs/claude-connector) ·
  106. [Claude Code plugin](https://mailbase.studio/docs/claude-code-plugin).
  107. Support: contact@mailbase.studio.
  108. ## License
  109. MIT for the files in this repository. The Mailbase service itself is hosted at
  110. [mailbase.studio](https://mailbase.studio) and is not open source.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.