Maildev Mcp
This server wraps the MailDev email testing tool with MCP, giving you programmatic control over a Docker container running a local SMTP sink. You get tools to start and stop the container with configurable ports and auth, then inspect received emails through MailDev's REST API. The workflow is built for test automation: trigger your app to send mail, call WaitForEmail to poll until it arrives, then use GetEmail, SearchEmails, or GetEmailHtml to validate the result. You can also pull attachment content as base64 or run byte-by-byte verification against expected payloads. Useful when you're testing email flows locally and want your AI assistant to orchestrate the SMTP environment and assertion logic without manual Docker or API wrangling.
- GitHub stars
- 2
- tools
- 12
- transport
- STDIO
- env var
- 1
- last updated
- Mar 19, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
StartMaildevStart the MailDev Docker container with configurable SMTP port, API port, authentication, and TLS
Start the MailDev Docker container with configurable SMTP port, API port, authentication, and TLS
No parameter schema in public metadata yet.
StopMaildevStop and remove the MailDev Docker container
Stop and remove the MailDev Docker container
No parameter schema in public metadata yet.
MaildevStatusCheck the running status of MailDev
Check the running status of MailDev
No parameter schema in public metadata yet.
ListEmailsRetrieve the list of received emails
Retrieve the list of received emails
No parameter schema in public metadata yet.
GetEmailGet the details of an email by ID, including attachment information
Get the details of an email by ID, including attachment information
No parameter schema in public metadata yet.
GetEmailHtmlGet the HTML body of an email by ID
Get the HTML body of an email by ID
No parameter schema in public metadata yet.
SearchEmailsSearch received emails by subject, sender, or recipient
Search received emails by subject, sender, or recipient
No parameter schema in public metadata yet.
DeleteEmailDelete a single email by ID
Delete a single email by ID
No parameter schema in public metadata yet.
DeleteAllEmailsDelete all received emails
Delete all received emails
No parameter schema in public metadata yet.
WaitForEmailWait until a new email matching given criteria arrives (useful for test automation)
Wait until a new email matching given criteria arrives (useful for test automation)
No parameter schema in public metadata yet.
GetAttachmentContentGet the raw Base64-encoded content of an email attachment
Get the raw Base64-encoded content of an email attachment
No parameter schema in public metadata yet.
VerifyAttachmentVerify that an email attachment matches the original data by byte-by-byte comparison
Verify that an email attachment matches the original data by byte-by-byte comparison
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MAILDEV_API_PORTPort number for the MailDev REST API (default: 1080)
Readme
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 MailDevMcp
After installation, the maildev-mcp command becomes available.
MCP Client Configuration
Add the following to your MCP client settings (e.g. Claude Desktop, VS Code, etc.):
Details
- Repository
- github.com/pierre3/maildevmcp
- Category
- Cloud & Infrastructure
- Package
MailDevMcp- Transport
- STDIO
- Registry
- MCP registry, active
More from pierre3
Related Cloud & Infrastructure MCP servers
View all
Mcp Guardianrudraneel93/mcp-guardianSecurity, cost, and health governance proxy for MCP infrastructure2stars
DevDoctorbannawat01/devdoctorRead-only local diagnostics for Rust, Node, Docker, ports, and environment configuration.1stars
GoldenFlowbenseverndev-oss/goldenflowStandardize, reshape, and normalize messy data — CSV, Excel, Parquet, S3, databases.1stars
Uptimebolt Mcp Serverclm-cloud-solutions/uptimebolt-mcp-serverAI-powered infrastructure monitoring — health, incidents, predictions, RCA, deploy safety1stars
Warmth Engine Observatorywarmthengine/warmth-engine-observatoryCoordination Intelligence: AI infrastructure coordination dynamics across geopolitical blocs1stars
Nexusaddozhang/nexus-mcp-serverQuery Sonatype Nexus Repository (OSS/Pro) for Maven, Python, and Docker artifacts1stars