Mailbuttons
Give an AI agent a governed inbox: sandboxed by default, human approval to email out
- 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/rpcAdd to Settings → Connectors → Add custom connector
https://mailbuttons.com/api/v1/mcp/rpcAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mailbuttons.com/api/v1/mcp/rpc"
}
}
}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/rpcEnter 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.RequiredMAILBUTTONS_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.