mailtrap/mailtrap-mcp

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.
Send transactional and bulk email, test messages safely in Email Sandbox, manage templates, contacts, sending domains, and webhooks, inspect email logs and delivery statistics, troubleshoot deliverability, and manage account resources — all using natural-language prompts.
Capabilities
- **Email API and SMTP** — Send transactional and bulk email, including batch and template-based messages.
- **Email testing** — Test messages in Email Sandbox and inspect content, headers, attachments, spam scores, and HTML client compatibility.
- **Delivery monitoring** — Search email logs, inspect event history, and analyze delivery, bounce, open, click, and spam rates.
- **Email infrastructure** — Manage sending domains, DNS verification, webhooks, and suppressions.
- **Contacts** — Manage contacts, lists, custom fields, and events, with imports and exports.
- **Account management** — Review billing usage and manage access, permissions, API tokens, and sub-accounts.
Supported MCP Clients
Works with Claude Desktop, Claude Code, Cursor, VS Code, and any other MCP-compatible client. Setup instructions for each are below.
Prerequisites
Before using this MCP server, you need to:
1. Create a Mailtrap account
2. Verify your domain
3. Get your API token from Mailtrap API settings
4. Get your Account ID from Mailtrap account management
**Required Environment Variables:**
- MAILTRAP_API_TOKEN - Required for all functionality
- MAILTRAP_ACCOUNT_ID - Required for templates, stats, email logs, sandbox list/show, sending domains, and suppressions. Optional only for the send tools (send-email, send-sandbox-email, and the batch-send-\* tools), the email campaign tools, the company info tools, and the tracking opt-out tools.
**Optional (can be passed as tool parameters instead):**
- DEFAULT_FROM_EMAIL - Default sender email when from is not provided to send-email, send-sandbox-email, or the batch-send-\* tools (where it fills base.from). Enables switching sender per call via the from parameter.
- MAILTRAP_SANDBOX_ID - Default sandbox (test inbox) ID when a tool's sandbox_id is not provided (legacy test_inbox_id on send/list/show sandbox message tools still accepted). Enables switching inboxes per call via parameters.
- MAILTRAP_TEST_INBOX_ID - Legacy alias for MAILTRAP_SANDBOX_ID; still read as a fallback for existing configs.
- MAILTRAP_ORGANIZATION_ID - Required for organization tools (list-sub-accounts, create-sub-account).
- MAILTRAP_ORGANIZATION_API_TOKEN - Organization-scoped API token. Required for organization tools (separate from MAILTRAP_API_TOKEN).
Quick Install
Docker
Run the server over stdio with the Docker MCP Catalog image:
See Prerequisites for required and optional environment variables.
To build from this repository: docker build -t mcp/mailtrap .
Smithery CLI
Smithery is a registry and installer for MCP servers that works with AI clients.
Install the published server (mailtrap/mailtrap-mcp) into a local client (replace the client name as needed):
See the Smithery CLI docs for other clients (cursor, windsurf, etc.) and for publishing updates.
Setup
Claude Desktop
Use MCPB to install the Mailtrap server. You can find those files in Releases. Download .MCPB file and open it. If you have Claude Desktop - it will open it and suggest to configure.
Claude Desktop or Cursor
Add the following configuration:
If you are using asdf for managing Node.js you must use absolute path to executable (example for Mac)
Claude Desktop config file location
**Mac**: ~/Library/Application Support/Claude/claude_desktop_config.json
**Windows**: %APPDATA%\Claude\claude_desktop_config.json
Cursor config file location
**Mac**: ~/.cursor/mcp.json
**Windows**: %USERPROFILE%\.cursor\mcp.json
VS Code
Manually changing config
Run in Command Palette: Preferences: Open User Settings (JSON)
Then, in the settings file, add the following configuration:
> [!TIP]
> Don't forget to restart your MCP server after changing the "env" section.
MCP Bundle (MCPB)
For easy installation in hosts that support MCP Bundles, you can distribute an .mcpb bundle file.
This creates mailtrap-mcp.mcpb using the repository manifest.json and built artifacts in dist/.
Usage
Once configured, you can ask agent to send emails and manage templates, for example:
**Email Sending Operations:**
- "Send an email to john.doe@example.com with the subject 'Meeting Tomorrow' and a friendly reminder about our upcoming meeting."