Mailtrap MCP Server
Official Mailtrap MCP server: send email, test in the sandbox, read delivery logs, manage templates, contacts and domains
- 66 ★ on the repository
- Last commit
Broad access
Why this level
- Sends real email and bulk campaigns from your domain
- Reads contacts and email logs, manages tokens and sub-accounts
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mailtrap-mcp-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Sends real email and bulk campaigns from your domain
- Reads contacts and email logs, manages tokens and sub-accounts
This is third-party code. Review the repository files before installing.
What it does
The server connects a Mailtrap account to an agent. The agent sends transactional and bulk email through the API or SMTP, including template-based and batch messages, and tests messages in the sandbox: content, headers, attachments, spam score and HTML client compatibility. It also manages templates, contacts and lists, domains with DNS verification, webhooks and suppressions. Event logs and statistics help troubleshoot undelivered mail and measure delivery, bounce, open and click rates. A separate tool group manages access, tokens and sub-accounts.
Who it is for. Developers and marketers who send email through Mailtrap and want to manage it from an agent.
Good fit when
- You want to run a new message through the sandbox and get a spam score before a campaign
- You need to find out from the logs why a message did not reach the recipient
- You want to create a template and send a test batch without opening the dashboard
- You want to check how a message renders in different mail clients without sending it to customers
- You need to clean the suppression list after spam complaints
Not a fit when
- You do not use Mailtrap: the server only speaks its API
- You need to send from an account without a verified domain
- You cannot hand an agent a token that can send real email
Example request
Send a test message to the sandbox and show its spam score and headersMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
MAILTRAP_API_TOKENrequired, secret- Mailtrap API token
MAILTRAP_ACCOUNT_ID- Account ID for templates, logs, sandboxes and domains
DEFAULT_FROM_EMAIL- Default sender address
Limitations
Requires a Mailtrap account, a verified domain, an API token and Node.js 22 or newer (or the Docker image). Organization tools need a separate organization-scoped token. The API token allows sending email and managing contacts, so use a dedicated minimal-permission token for experiments. Organization tools need MAILTRAP_ORGANIZATION_ID and an organization token; the old name MAILTRAP_TEST_INBOX_ID is still read but logs a deprecation warning.
How to disable. Delete the `mailtrap` entry from the client configuration and revoke the token in Mailtrap API settings.
FAQ
How do I install it in Claude Desktop?
Download the .mcpb file from Releases and open it in Claude Desktop, which prompts for the settings.
Which variables are required?
MAILTRAP_API_TOKEN is needed for everything, and templates, logs, sandboxes and domains also need MAILTRAP_ACCOUNT_ID.
Can I run it in Docker?
Yes, the image runs over stdio from the Docker MCP catalog with the same MAILTRAP_API_TOKEN and MAILTRAP_ACCOUNT_ID variables.
How does the sandbox differ from normal sending?
The sandbox accepts messages into a Mailtrap test inbox where headers, attachments and spam score are inspected, and recipients receive nothing.
Is Node.js required?
Yes, version 22 or newer, unless you run the Docker image.
Discussion
No questions or reviews yet.
Related
MCP serversThe official Postmark MCP server: 24 tools to send email, manage templates, search messages and diagnose delivery.
The Atomic Mail MCP server: an agent creates its own atomicmail.ai inbox and works with mail through JMAP with no human involved.
Resend's official MCP server: send and read email, manage contacts, broadcasts, domains and webhooks from your agent
Open Agent Email — a self-hosted mail server for AI agents: inboxes, in-thread replies, human approval, webhooks and an MCP endpoint with 96 tools
UniOne and Unisender Go MCP server
mcp-unione
An MCP server for UniOne and Unisender Go transactional email, with a send guard against accidental sends and an offline API knowledge base
An inbox for an AI agent: send, receive and reply in thread through MCP with optional human approval
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Mailtrap MCP Server (this card) | yes | API key | 66 | |
| mcp-email-server | no | not required | 393 | A generic SMTP and IMAP mail server without sandbox or delivery logs. |
| Resend MCP Server | yes | OAuth | 580 | Server for a different email service, Resend, without a message-testing sandbox. |
README in short
The README lists server capabilities, prerequisites and environment variables. It shows installation through Cursor, VS Code, Docker, Smithery and an MCPB file.