MailDevMcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
# MailDevMcp
English | 日本語
mcp-name: io.github.pierre3/maildev-mcp
An MCP (Model Context Protocol) server for MailDev.
Manage MailDev Docker containers and inspect received emails directly from your AI-powered editor or MCP client.
This server is intended for local development and test automation scenarios where an MCP client needs to:
start or stop a MailDev container
inspect inbox contents
wait for emails after triggering application behavior
inspect HTML bodies and attachments
verify attachment integrity byte-for-byte
Installation
Install as a global .NET tool:
dotnet tool install -g MailDevMcpAfter installation, the maildev-mcp command becomes available.
Related MCP server: @injaan.dev/ms365-email-cli-mcp
MCP Client Configuration
Add the following to your MCP client settings (e.g. Claude Desktop, VS Code, etc.):
{
"mcpServers": {
"maildev-mcp": {
"command": "maildev-mcp",
"env": {
"MAILDEV_API_PORT": "1080"
}
}
}
}Environment Variables
Variable | Default | Description |
|
| Port number for the MailDev REST API |
Typical Workflow
Call
StartMaildevto launch a local MailDev containerTrigger your application to send an email
Call
WaitForEmailif delivery is asynchronousUse
ListEmails,SearchEmails, orGetEmailto inspect the resultUse
GetEmailHtml,GetAttachmentContent, orVerifyAttachmentwhen deeper validation is neededClean up with
DeleteEmail,DeleteAllEmails, orStopMaildev
Available Tools
Tool | Description |
| Start the MailDev Docker container with configurable SMTP port, API port, authentication, and TLS |
| Stop and remove the MailDev Docker container |
| Check the running status of MailDev |
| Retrieve the list of received emails |
| Get the details of an email by ID, including attachment information |
| Get the HTML body of an email by ID |
| Search received emails by subject, sender, or recipient |
| Delete a single email by ID |
| Delete all received emails |
| Wait until a new email matching given criteria arrives (useful for test automation) |
| Get the raw Base64-encoded content of an email attachment |
| Verify that an email attachment matches the original data by byte-by-byte comparison |
Tool Behavior Notes
StartMaildevSupports custom SMTP and API ports
Supports optional SMTP authentication
Treats empty or whitespace-only credentials as authentication disabled
Supports TLS with a generated self-signed certificate
GetEmailandListEmailsRender missing or empty subjects as
(no subject)Render missing address lists as
(none)
WaitForEmailPolls MailDev until a matching email arrives or the timeout is reached
Reports transient MailDev connection failures in the returned message when they occur during polling
VerifyAttachmentAccepts a Base64-encoded original payload
Compares the received attachment byte-by-byte
Reports either exact match, size mismatch, or content mismatch
Requirements and Assumptions
Docker must be installed and available on the same machine where this MCP server runs
MailDev is accessed through its HTTP API on
localhostThe configured API port in the MCP client must match the MailDev API port exposed by Docker
Prerequisites
.NET 10 SDK or later
Docker (for running the MailDev container)
Building from Source
git clone https://github.com/pierre3/MailDevMcp.git
cd MailDevMcp
dotnet pack -c Release
dotnet tool install -g --add-source ./bin/Release MailDevMcpLicense
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read the verification code (OTP) and test emails your app sends to a catch-all test hostname. Four read-only tools: list_domains, get_latest_otp, list_messages, get_message. Needs a MailBots API key from the 14-day free trial (no card, no DNS) or a paid plan. Setup: https://mailbots.top/docs/mcp
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email: search, read, fetch attachments; attach files when the MCP client supports inputs.
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides MCP tools for setting up and managing Hephaestus development environment with Docker containers, including starting/stopping services, initializing databases, and troubleshooting.79 PyPIMIT
- AlicenseAqualityDmaintenanceDeprecated MCP server wrapper for ms365-email-cli that exposes Microsoft 365 email operations (list, read, send, reply, search, etc.) as MCP tools. Use the main ms365-email-cli package instead, which now includes built-in MCP server support.1012 npmISC
- FlicenseNot gradedqualityCmaintenanceCentralizes Thunderbird email operations as MCP tools: read, send, draft, search, attachments.-
- FlicenseAqualityDmaintenanceProvides a dummy SMTP server for catching emails during development, with MCP tools to list, retrieve, and manage received messages.4-