Mailtrap
Mailtrap is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Official MCP Server for Mailtrap. It has 65 GitHub stars, is released under the MIT license and runs locally with npx -y mcp-mailtrap.
- Official
- Needs API key
- Communication
- MIT
- Actively maintained
Install Mailtrap
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"mailtrap": {
"command": "npx",
"args": [
"-y",
"mcp-mailtrap"
],
"env": {
"MAILTRAP_API_TOKEN": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env MAILTRAP_API_TOKEN=your-value --transport stdio mailtrap -- npx -y mcp-mailtrapCursor
{
"mcpServers": {
"mailtrap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-mailtrap"
],
"env": {
"MAILTRAP_API_TOKEN": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "mailtrap_api_token",
"description": "MAILTRAP_API_TOKEN",
"password": true
}
],
"servers": {
"mailtrap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-mailtrap"
],
"env": {
"MAILTRAP_API_TOKEN": "${input:mailtrap_api_token}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
MAILTRAP_API_TOKENsecret | Yes | Mailtrap API token from https://mailtrap.io/api-tokens |
MAILTRAP_ACCOUNT_ID | No | Mailtrap account ID from https://mailtrap.io/account-management |
Tools (40)
Parsed from the Tools section of the README; check the repository for the current list.
send-emailSends a transactional email through Mailtrap. Supports two mutually exclusive modes — inline content (subject +…
fromSender as { email, name? } (a bare email string is also accepted at runtime). If not provided, DEFAULTFROMEMAIL is used.
subjectEmail subject line. Required for inline sends; must be omitted when templateuuid is set.
textEmail body text. Required (alongside or instead of html) for inline sends; must be omitted when templateuuid is set.
htmlHTML version of the email body. Required (alongside or instead of text) for inline sends; must be omitted when…
categoryEmail category for tracking and analytics. Must be omitted when templateuuid is set.
template_uuidUse a Mailtrap email template instead of inline content. When set, subject / text / html / category must be omitted…
template_variablesObject of variables substituted into the template referenced by templateuuid. Only allowed together with templateuuid.
batch-send-transactional-emailSends a batch of transactional emails in one Mailtrap API call (default sending stream).
baseObject with fields shared across the batch.
reply_toReply-to address.
custom_variablesDefault custom variables (string-valued).
headersDefault custom headers.
requestsNon-empty array of per-recipient messages. Each entry has:
batch-send-bulk-emailSends a batch of bulk emails through Mailtrap's bulk-stream API.
list-email-logsLists sent email logs (delivery history) with optional pagination and filters.
search_afterPagination cursor from the previous response's nextpagecursor
sent_afterISO 8601 date/time; only logs sent after this time
sent_beforeISO 8601 date/time; only logs sent before this time
from_emailFilter by sender email; use with fromoperator (default: ci_equal)
to_emailFilter by recipient email; use with tooperator (default: ci_equal)
statusFilter by delivery status: delivered, notdelivered, enqueued, optedout; use with statusoperator (default: equal)
sending_domain_idFilter by sending domain ID (number); use with sendingdomainidoperator (default: equal)
sending_streamFilter by stream: transactional or bulk; use with sendingstreamoperator (default: equal)
eventsFilter by event type(s): delivery, open, click, bounce, spam, unsubscribe, softbounce, reject, suspension; use with…
clicks_count/ openscount (optional): Filter by click/open count; use with operator: equal, greaterthan, lessthan
client_ip/ sendingip (optional): Filter by IP; use with operator: equal, notequal, contain, notcontain
email_service_provider_responseFilter by provider response text; use with operator (ci_contain, etc.)
email_service_providerFilter by provider (exact); use with operator: equal, not_equal
recipient_mxFilter by recipient MX; use with recipientmxoperator (ci_contain, etc.)
get-email-log-messageGets a single email log message by ID (UUID): a readable summary (from, to, subject, sent time, status, category,…
message_idUUID of the email log message (from send response or list-email-logs). Use list-email-logs to find message IDs.
include_contentWhen true, fetches the raw EML (if rawmessageurl is available) and appends parsed HTML and plain-text body sections,…
get-sending-statsGet email sending statistics (delivery, bounce, open, click, spam rates) for a date range.
start_dateStart date for the stats range (YYYY-MM-DD)
end_dateEnd date for the stats range (YYYY-MM-DD)
breakdownHow to break down the stats: aggregated (default), bydomain, bycategory, byemailserviceprovider, or bydate
sending_domain_idsLimit results to these sending domain IDs (array of integers)
sending_streamsLimit to transactional and/or bulk (array of strings)
categoriesLimit to these email categories (array of strings)
About Mailtrap
The official MCP server for Mailtrap — the email delivery platform. It connects your Mailtrap account to Claude, Cursor, VS Code, and other MCP-compatible AI assistants.
- ai-agents
- bulk-email
- claude
- cursor
- email-api
- email-delivery
- email-sandbox
- email-testing
- mailtrap
Similar MCP servers
More communication MCP servers
Strata
Klavis-AI/klavis
MCP server for progressive tool usage at any scale (see https://klavis.ai).
OfficialCommunicationPythonVexa
Vexa-ai/vexa
Meeting bot and transcripts for Google Meet, Teams and Zoom.
OfficialCommunicationPythonMCP Server for WinDbg Crash Analysis
svnscha/mcp-windbg
A Model Context Protocol server for Windows crash dump analysis using WinDbg/CDB.
CommunicationPythonRocketmq Rust
mxsm/rocketmq-rust
🚀 Apache RocketMQ built in Rust 🦀 — faster, safer, and more memory-efficient.
CommunicationRustWassette
microsoft/wassette
Wassette: A security-oriented runtime that runs WebAssembly Components via MCP.
OfficialCommunicationRustLine Bot MCP Server
line/line-bot-mcp-server
MCP server that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.
OfficialCommunicationTypeScript
What is Mailtrap?
Mailtrap is an MCP server that adds messaging tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Official MCP Server for Mailtrap. It has 65 GitHub stars, is released under the MIT license and runs locally with npx -y mcp-mailtrap. The source code is at github.com/mailtrap/mailtrap-mcp.
How do I install the Mailtrap MCP server?
Add the command npx -y mcp-mailtrap to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Mailtrap free?
The server is open source under the MIT license, so running it is free. It needs credentials (MAILTRAP_API_TOKEN) for the service it connects to, which may require a paid account.
Is Mailtrap actively maintained?
The most recent commit was on Oct 2, 2026. The latest release is v0.9.0, published Sep 1, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.