MailSandbox is a fast, zero-dependency email testing tool & API with a web UI, SMTP server, Postmark API emulation, and MCP server for AI-assisted debugging.
{
"mcpServers": {
"mailsandbox": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
> Fork of Mailpit adding Postmark API emulation and an MCP server for AI-assisted debugging. > Inspired by and grateful to the original work on Mailpit and MailHog. See Credits.
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
MIT. View license →
Is it maintained?
Last commit 212 days ago. 8 stars.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
Context cost
4 tools. ~100 tokens (0.1% of 200K).
Fork of Mailpit adding Postmark API emulation and an MCP server for AI-assisted debugging.
Inspired by and grateful to the original work on Mailpit and MailHog. See Credits.
Repository • Installation • Usage • Postmark API • MCP Server
MailSandbox is a small, fast, low-memory, zero-dependency, multi-platform email testing tool & API for developers.
It provides an SMTP server, modern web interface, REST API, Postmark API emulation, and an MCP server for AI-powered workflows.
List-Unsubscribe validationThe web UI runs on http://0.0.0.0:8025 and SMTP on 0.0.0.0:1025.
sudo sh < <(curl -sL https://raw.githubusercontent.com/btafoya/mailsandbox/main/install.sh)
Download from releases, rename to mailsandbox, and add to $PATH.
docker run -d --name mailsandbox -p 8025:8025 -p 1025:1025 btafoya/mailsandbox
List options:
mailsandbox -h
Enable Postmark API emulation:
mailsandbox --postmark-api --postmark-token "your-secret-token"
Environment variables:
export MP_POSTMARK_API=true
export MP_POSTMARK_TOKEN=your-secret-token
mailsandbox
Example: Node.js
const postmark = require("postmark");
const client = new postmark.ServerClient("your-secret-token");
client.apiUrl = "http://localhost:8025";
client.sendEmail({ From:"a@x.com", To:"b@y.com", Subject:"Test", TextBody:"Hello" });
Endpoints:
POST /emailNo automated test available for this server. Check the GitHub README for setup instructions.
list_messageslist/filter emails
get_messageretrieve full message
search_messagesadvanced search
analyze_messageHTML, links, spam scoring
No known vulnerabilities.
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite
An open-source AI agent that brings the power of Gemini directly into your terminal.
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
MCP Security Weekly
Get CVE alerts and security updates for Mailsandbox and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.