Back to search
mailbase-mcp
MCP serverFreemiumGitHub
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
Markdown
[](/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
- # Mailbase MCP server
- Connect Claude, Claude Code, Cursor, Codex, VS Code or any MCP client to
- [Mailbase](https://mailbase.studio): 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)
- 1. Settings → Connectors → **Add custom connector**.
- 2. Name it `Mailbase`, paste `https://mailbase.studio/api/mcp/mcp`.
- 3. 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:
- ```sh
- 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):
- ```json
- {
- "mcpServers": {
- "mailbase": {
- "url": "https://mailbase.studio/api/mcp/mcp"
- }
- }
- }
- ```
- Then open Cursor Settings → MCP and click **Connect** next to `mailbase`.
- ### Codex
- ```sh
- codex mcp add mailbase --url https://mailbase.studio/api/mcp/mcp
- ```
- The ChatGPT / Codex plugin manifest is in [`plugins/mailbase/plugin.json`](plugins/mailbase/plugin.json).
- ### VS Code (GitHub Copilot agent mode)
- Add to `.vscode/mcp.json`:
- ```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/`](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`](server.json) | Entry for the [official MCP Registry](https://registry.modelcontextprotocol.io) |
- | [`clients/`](clients/) | Config snippets for Claude Code, Codex, Cursor and VS Code |
- | [`plugins/mailbase/`](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](https://github.com/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](https://mailbase.studio/features/transactional-email).
- ## Related
- - [mailbase-cli](https://github.com/amintt2/mailbase-cli): the `mailbase` command-line client
- - [mailbase-examples](https://github.com/amintt2/mailbase-examples): `POST /api/v1/send` in Next.js, Express and Python
- - [email-dns-check](https://github.com/amintt2/email-dns-check): SPF, DKIM, DMARC and MX checks
- Docs: [MCP OAuth setup](https://mailbase.studio/docs/mcp-oauth) ·
- [Claude connector](https://mailbase.studio/docs/claude-connector) ·
- [Claude Code plugin](https://mailbase.studio/docs/claude-code-plugin).
- Support: contact@mailbase.studio.
- ## License
- MIT for the files in this repository. The Mailbase service itself is hosted at
- [mailbase.studio](https://mailbase.studio) and is not open source.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.