# Mailbuttons

> Mailbuttons is an MCP server for communication. Give an AI agent a governed inbox: sandboxed by default, human approval to email out. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** API, CLI, Web
- **Website:** https://mailbuttons.com
- **Repository:** https://github.com/mailbuttons/mcp-server
- **MCP Registry name:** com.mailbuttons/mcp-server
- **Categories:** [communication](https://ai-powered.com/categories/communication), [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

## Alternatives

- [Botmail](https://ai-powered.com/mcp/botmail): Botmail is an MCP server for communication.
- [MachineMail](https://ai-powered.com/mcp/machinemail): MachineMail is a freemium MCP server for communication.
- [Mailly](https://ai-powered.com/mcp/mailly): Mailly is an MCP server for communication.
- [Mailows](https://ai-powered.com/mcp/mailows): Mailows is a freemium MCP server for communication.
- [Mails.ai — Agent Email](https://ai-powered.com/mcp/mails-ai-agent-email): Mails.ai — Agent Email is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Innmail for Agents](https://ai-powered.com/mcp/innmail-for-agents): Innmail for Agents is a free MCP server for communication.
- [SendForAI](https://ai-powered.com/mcp/sendforai): SendForAI is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/mailbuttons
