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 66 GitHub stars, is released under the MIT license and runs locally with npx -y mcp-mailtrap.
github.com/mailtrap/mailtrap-mcp (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
- Official
- Needs API key
- Communication
- MIT
- Active
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.
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 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 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
gtm-api: LinkedIn MCP Server
gtm-api/linkedin-mcp
Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.
Maintained · last commit Nov 15, 2026
OfficialCommunicationTypeScriptOutlook Assistant
littlebearapps/outlook-assistant
Microsoft Outlook MCP server — 22 tools for email, calendar, contacts, and mailbox management.
Active · last commit Nov 16, 2026
OfficialCommunicationJavaScriptPulsemcp Gmail
pulsemcp/mcp-servers
MCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.
Maintained · last commit Aug 30, 2026
OfficialCommunicationTypeScriptInfobip MCP Server
infobip/mcp
Infobip MCP server for omnichannel communication and messaging.
Maintained · last commit Sep 28, 2026
OfficialCommunicationBasecamp MCP Server
georgeantonopoulos/Basecamp-MCP-Server
MCP server for Basecamp 3 with OAuth, FastMCP, and 75 tools for projects, todos, messages, card tables, docs, uploads, and search.
Active · last commit Nov 12, 2026
CommunicationPythonBesidka
besidka/besidka
Besidka models, providers and key guides, plus your chats, projects, files, memory and settings.
Maintained · last commit Nov 15, 2026
OfficialCommunicationTypeScript
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 Nov 13, 2026. The latest release is v0.13.1, published Nov 13, 2026. appsgit only lists MCP servers with a commit in the last six months.