1. Conduid
  2. Communication
  3. io.github.pierre3/maildev-mcp
MCP server · Communication

io.github.pierre3/maildev-mcp

by · github.com/pierre3/MailDevMcp

MailDev MCP server. Manage Docker containers and inspect emails from your AI editor or MCP client.

Unclaimed last commit 7 months ago comms
InstallView source
34Low

Scored 6 months ago · breakdown

About io.github.pierre3/maildev-mcp

io.github.pierre3/maildev-mcp is an MCP server published by pierre3 in the Communication category: mailDev MCP server. Manage Docker containers and inspect emails from your AI editor or MCP client.

The repository has 2 stars and 0 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/pierre3/MailDevMcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (12)

DeleteAllEmailsDelete all received emails

Parameters not published.

DeleteEmailDelete a single email by ID

Parameters not published.

GetAttachmentContentGet the raw Base64-encoded content of an email attachment

Parameters not published.

GetEmailGet the details of an email by ID, including attachment information

Parameters not published.

GetEmailHtmlGet the HTML body of an email by ID

Parameters not published.

ListEmailsRetrieve the list of received emails

Parameters not published.

MaildevStatusCheck the running status of MailDev

Parameters not published.

SearchEmailsSearch received emails by subject, sender, or recipient

Parameters not published.

StartMaildevStart the MailDev Docker container with configurable SMTP port, API port, authentication, and TLS

Parameters not published.

StopMaildevStop and remove the MailDev Docker container

Parameters not published.

VerifyAttachmentVerify that an email attachment matches the original data by byte-by-byte comparison

Parameters not published.

WaitForEmailWait until a new email matching given criteria arrives (useful for test automation)

Parameters not published.

Ask AI

✦

Ask AI about io.github.pierre3/maildev-mcp

Powered by Claude · Grounded in docs

I know everything about io.github.pierre3/maildev-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

# MailDevMcp

English | 日本語

CI NuGet

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.):

{
  "mcpServers": {
    "maildev-mcp": {
      "command": "maildev-mcp",
      "env": {
        "MAILDEV_API_PORT": "1080"
      }
    }
  }
}

Environment Variables

Variable Default Description
MAILDEV_API_PORT 1080 Port number for the MailDev REST API

Typical Workflow

  1. Call StartMaildev to launch a local MailDev container
  2. Trigger your application to send an email
  3. Call WaitForEmail if delivery is asynchronous
  4. Use ListEmails, SearchEmails, or GetEmail to inspect the result
  5. Use GetEmailHtml, GetAttachmentContent, or VerifyAttachment when deeper validation is needed
  6. Clean up with DeleteEmail, DeleteAllEmails, or StopMaildev

Available Tools

Tool Description
StartMaildev Start the MailDev Docker container with configurable SMTP port, API port, authentication, and TLS
StopMaildev Stop and remove the MailDev Docker container
MaildevStatus Check the running status of MailDev
ListEmails Retrieve the list of received emails
GetEmail Get the details of an email by ID, including attachment information
GetEmailHtml Get the HTML body of an email by ID
SearchEmails Search received emails by subject, sender, or recipient
DeleteEmail Delete a single email by ID
DeleteAllEmails Delete all received emails
WaitForEmail Wait until a new email matching given criteria arrives (useful for test automation)
GetAttachmentContent Get the raw Base64-encoded content of an email attachment
VerifyAttachment Verify that an email attachment matches the original data by byte-by-byte comparison

Tool Behavior Notes

  • StartMaildev
    • Supports 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
  • GetEmail and ListEmails
    • Render missing or empty subjects as (no subject)
    • Render missing address lists as (none)
  • WaitForEmail
    • Polls 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
  • VerifyAttachment
    • Accepts 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 localhost
  • The configured API port in the MCP client must match the MailDev API port exposed by Docker

Prerequisites

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 MailDevMcp

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.pierre3/maildev-mcp

How do I install io.github.pierre3/maildev-mcp?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is io.github.pierre3/maildev-mcp safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.pierre3/maildev-mcp still maintained?

The last commit was 7 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.