Summary
Connects Claude to Mailtrap's email infrastructure with 48 tools covering analytics, transactional and bulk sending, contact management, and sandbox testing. You get operations for sending stats by domain or ESP, email logs with suppression handling, template CRUD with react-email rendering support, contact imports up to 50k records, and full sandbox control including spam analysis and message forwarding. Useful when you're building email workflows and want to query delivery metrics, manage contact lists, or debug messages without leaving your AI chat. Supports both the general API and dedicated sending tokens, with optional defaults for sender addresses and test inboxes to speed up common tasks.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
mcpj-mailtrap
Mailtrap MCP server — analytics, email logs, contacts, sandbox testing & more via natural language.
Built with Bun + TypeScript. Works with Claude, Cursor, and any MCP client.
Quick Start
1. Get Your API Token
Get an API token from Mailtrap API Tokens.
2. Add to Claude Code
Minimal
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- npx mcpj-mailtrap
Full
claude mcp add mailtrap \
-e MAILTRAP_API_TOKEN=your_token \
-e MAILTRAP_SENDING_TOKEN=your_sending_token \
-e MAILTRAP_ACCOUNT_ID=12345 \
-e MAILTRAP_DEFAULT_FROM_EMAIL=noreply@yourdomain.com \
-e MAILTRAP_TEST_INBOX_ID=12345 \
-- npx mcpj-mailtrap
That's it. Restart Claude Code and the tools are available.
Also works with
bunx mcpj-mailtrap@latestif you have Bun. Requires Node 18+ when running vianpx.
Claude Desktop / Cursor
Minimal
{
"mcpServers": {
"mailtrap": {
"command": "npx",
"args": ["-y", "mcpj-mailtrap@latest"],
"env": {
"MAILTRAP_API_TOKEN": "your_token"
}
}
}
}
Full
{
"mcpServers": {
"mailtrap": {
"command": "npx",
"args": ["-y", "mcpj-mailtrap@latest"],
"env": {
"MAILTRAP_API_TOKEN": "your_token",
"MAILTRAP_SENDING_TOKEN": "your_sending_token",
"MAILTRAP_ACCOUNT_ID": "12345",
"MAILTRAP_DEFAULT_FROM_EMAIL": "noreply@yourdomain.com",
"MAILTRAP_TEST_INBOX_ID": "12345"
}
}
}
}
Alternative: standalone binary
Download a pre-built binary from Releases:
| Platform | File |
|---|---|
| macOS (Apple Silicon) | mcpj-mailtrap-darwin-arm64 |
| macOS (Intel) | mcpj-mailtrap-darwin-x64 |
| Linux | mcpj-mailtrap-linux-x64 |
| Windows | mcpj-mailtrap-windows-x64.exe |
macOS / Linux:
curl -Lo mcpj-mailtrap https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-darwin-arm64
chmod +x mcpj-mailtrap
sudo mv mcpj-mailtrap /usr/local/bin/
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- /usr/local/bin/mcpj-mailtrap
Windows (PowerShell):
Invoke-WebRequest -Uri "https://github.com/pijusz/mcp-mailtrap/releases/latest/download/mcpj-mailtrap-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\mcpj-mailtrap.exe"
claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- "%LOCALAPPDATA%\mcpj-mailtrap.exe"
Tools (48)
Analytics
| Tool | Description |
|---|---|
get_stats | Sending statistics — delivery, bounce, open, click, spam rates. Group by domain, category, ESP, or date |
Email Logs
| Tool | Description |
|---|---|
get_email_logs | List sent emails with filtering by status, stream, date. Cursor-based pagination |
get_email_log | Single message detail with delivery events timeline |
get_suppressions | List suppressed emails (bounces, spam complaints, unsubscribes) |
delete_suppression | Re-enable sending to a suppressed address |
check_list_hygiene | Find suppressed emails that still exist in contact lists and suggest exact cleanup actions |
Sending
| Tool | Description |
|---|---|
send_email | Send via transactional or bulk stream. Supports HTML, text, or templates |
batch_send | Send up to 500 emails in one request |
send_test_email | Send to a sandbox inbox for testing, with optional env defaults for inbox and sender |
Templates
| Tool | Description |
|---|---|
list_templates | List all email templates |
get_template | Get template details including HTML/text body |
create_template | Create a new template |
update_template | Update an existing template |
delete_template | Delete a template |
render_react_email | Render a react-email component file (.tsx, .jsx, .js, .mjs) to HTML + plain text |
Contacts
| Tool | Description |
|---|---|
create_contact | Create a contact with email, custom fields, list membership |
get_contact | Get contact by UUID or email |
update_contact | Update contact fields, list membership, subscription status |
delete_contact | Delete a contact |
trigger_contact_event | Trigger automations for a contact |
list_contact_lists | List all contact lists |
get_contact_list | Get a single contact list |
create_contact_list | Create a new contact list |
update_contact_list | Rename a contact list |
delete_contact_list | Delete a contact list |
manage_contact_field | List, get, create, update, or delete custom contact fields |
import_contacts | Bulk import up to 50k contacts, or check import status |
export_contacts | Start contact export or check export status |
Email Sandbox
| Tool | Description |
|---|---|
list_projects | List sandbox projects with inboxes |
get_project | Get a single project |
manage_project | Create, update, or delete a project |
list_inboxes | List all sandbox inboxes |
get_inbox | Get inbox details (credentials redacted by default) |
manage_inbox | Create, update, clean, mark read, reset credentials, or delete |
get_messages | List messages in a sandbox inbox |
get_message | Get message body in HTML/text/raw/EML format, with optional attachments |
analyze_message | Combined spam score + HTML analysis + headers report |
forward_message | Forward a test message to an email |
Domains
| Tool | Description |
|---|---|
list_domains | List sending domains with DNS status |
get_domain | Get domain details including DNS records |
manage_domain | Create or delete a sending domain |
send_domain_setup_instructions | Email DNS setup instructions to a colleague |
Accounts
| Tool | Description |
|---|---|
list_accounts | List accounts or get one by ID |
get_billing_usage | Plan limits and current usage |
manage_account_access | List, remove, update permissions, view resources |
manage_api_token | List, get, create, delete, or reset API tokens |
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
MAILTRAP_API_TOKEN | Yes | — | General API token from mailtrap.io/api-tokens |
MAILTRAP_SENDING_TOKEN | No | MAILTRAP_API_TOKEN | Separate token for transactional and bulk send.api requests |
MAILTRAP_ACCOUNT_ID | No | auto-discovered | Default account ID |
MAILTRAP_DEFAULT_FROM_EMAIL | No | — | Default sender email for send_email / send_test_email |
MAILTRAP_TEST_INBOX_ID | No | — | Default sandbox inbox ID for send_test_email |
DEBUG | No | — | Enable debug logging |
Updates
Using npx @latest (recommended): You always get the latest version — no manual updates needed.
Using a binary: The server checks for new releases on startup and logs to stderr if outdated:
[mcpj-mailtrap] Update available: v0.2.0 (current: v0.1.0)
Check your installed version:
mcpj-mailtrap --version
Development
Requires Bun.
git clone https://github.com/pijusz/mcp-mailtrap.git
cd mcp-mailtrap
bun install
bun test # tests
bun run build # standalone binary
bun run inspect # MCP Inspector
bun run check # biome format + lint
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Registryactive
Packagemcpj-mailtrap
TransportSTDIO
UpdatedMar 23, 2026
