Skip to main content
Glama
Mailbase MCP server

Mailbase MCP server

by amintt2

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)

  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:

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/.

Related MCP server: reflow

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.

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Integrates with the Gmail API to send and read emails through MCP tools using Google OAuth authentication.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to create and manage durable email workflows, templates, contacts, and enrollments over MCP.
      2
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables sending transactional email and campaigns, managing contacts and templates, and reading delivery reports and wallet usage from any MCP client.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to send, receive, and track email and manage templates, domains, webhooks, and other email API operations from AI assistants.
      122 npm
      MIT