Skip to main content
Glama
Mailbase MCP server

Mailbase MCP server

by amintt2
README.md
# 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.