Skip to content
MCP server

Mailbuttons

Give an AI agent a governed inbox: sandboxed by default, human approval to email out

Install
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.1.4
Listing updated
5 days ago

Similar MCP servers

About Mailbuttons

Mailbuttons is an MCP server for communication. It can run locally on your machine or as a hosted remote server.

Mailbuttons' server is built around limiting what an agent can do with email. Tokens start in a sandbox, no tool can widen a token's own scope, and a send to an outside address becomes a draft that waits for a person, or is blocked with the rule that matched. Those outcomes are described as normal results, not errors. Every call, including denials, is audited, and returned email is treated as data, not instructions.

Twelve runtime tools cover listing messages and threads, reading attachments as text, governed sending, reviewing drafts, extracting verification codes from allowlisted senders, requesting sender allowlisting or promotion, and exporting the audit log. The local stdio package adds build-time helpers that generate a closed-by-default policy file and scaffold a send wrapper and webhook handler, plus a Claude Code skill.

Mailbuttons also sells email-addressable agents, such as a quoting agent from 29 pounds a month. This server is the route for building your own agent on the same platform.

Install

Run in a terminal

claude mcp add --transport http mcp-server https://mailbuttons.com/api/v1/mcp/rpc

Add to Settings → Connectors → Add custom connector

https://mailbuttons.com/api/v1/mcp/rpc
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mailbuttons.com/api/v1/mcp/rpc"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mailbuttons.com/api/v1/mcp/rpc"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mailbuttons.com/api/v1/mcp/rpc"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://mailbuttons.com/api/v1/mcp/rpc

Enter a Name (for example "Mailbuttons"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mailbuttons.com/api/v1/mcp/rpc"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MAILBUTTONS_API_KEYA scoped Mailbuttons MCP token (mb_sandbox_...). Sandbox-by-default; external send requires human promotion.Required
  • MAILBUTTONS_API_URLBackend base URL. Defaults to https://mailbuttons.com; set for self-hosted or local.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

mailbuttons_list_messages
Lists delivered messages in an inbox.
mailbuttons_get_message
Returns full body and attachment metadata.
mailbuttons_get_thread
Returns all messages in a thread.
mailbuttons_get_attachment_text
Reads text and CSV attachments inline.
mailbuttons_send_email
Governed send or reply; may draft or block.
mailbuttons_list_drafts
Lists sends held for approval.
mailbuttons_get_draft
Fetches one held draft.
mailbuttons_extract_code
Extracts a verification code from allowlisted senders.
mailbuttons_propose_sender
Files an allowlist request.
mailbuttons_request_promotion
Files a capability or promotion request.
mailbuttons_audit_tail
Reads recent governed tool calls.
mailbuttons_export_audit
Exports the audit log as JSONL or CEF.

What it does

Sandbox by default
Scoped tokens cannot grant themselves external send.
Human approval
Outside sends become drafts until a person approves.
Full audit trail
Every call, including denials, is logged and exportable as JSONL or CEF.
Verification codes
Extract OTPs only from allowlisted senders.
Policy scaffolding
Generate a closed-by-default policy file and integration code.
Remote or stdio
Hosted endpoint, or the npm package for local use.

Good for

  • Give a coding agent an inbox to test signup emails
  • Let an agent draft outbound emails that a person approves
  • Pull a verification code during an automated flow
  • Review what an agent sent and why
  • Export an audit log to a SIEM

Pricing

Pricing unknown

Hosted agents start at 29 pounds a month; API access pricing is not published.

Prices change. Check mailbuttons.com before you buy.

Mailbuttons FAQ

Can an agent send to anyone?

No. External sends from sandbox tokens become drafts or are blocked until a human promotes the token.

How do I authenticate?

With a scoped Mailbuttons MCP token (mb_sandbox_...) set as MAILBUTTONS_API_KEY.

What is exposed on the hosted endpoint?

The twelve governed runtime tools; the build-time helpers exist only in the stdio package.

Can PDF attachments be read?

Not yet; text and CSV are returned inline.

How do I add Mailbuttons to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mailbuttons.com/api/v1/mcp/rpc

What are the best alternatives to Mailbuttons?

The closest alternatives to Mailbuttons are Botmail, MachineMail, Mailly, Mailows and Mails.ai — Agent Email.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers