
Mcp Mailtrap
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.
- GitHub stars
- 3
- tools
- 46
- transport
- STDIO
- last updated
- Mar 23, 2026
Tools
46 toolsPublic tool metadata for what this MCP can expose to an agent.
get_statsSending statistics — delivery, bounce, open, click, spam rates. Group by domain, category, ESP, or date
Sending statistics — delivery, bounce, open, click, spam rates. Group by domain, category, ESP, or date
No parameter schema in public metadata yet.
get_email_logsList sent emails filtered by status, stream, date range, recipient, sender, subject, or category. Cursor-based pagination
List sent emails filtered by status, stream, date range, recipient, sender, subject, or category. Cursor-based pagination
No parameter schema in public metadata yet.
get_email_logSingle message detail with delivery events timeline
Single message detail with delivery events timeline
No parameter schema in public metadata yet.
get_suppressionsList suppressed emails (bounces, spam complaints, unsubscribes) with the IDs delete_suppression needs
List suppressed emails (bounces, spam complaints, unsubscribes) with the IDs delete_suppression needs
No parameter schema in public metadata yet.
delete_suppressionRe-enable sending to a suppressed address
Re-enable sending to a suppressed address
No parameter schema in public metadata yet.
check_list_hygieneFind suppressed emails that still exist in contact lists and suggest exact cleanup actions
Find suppressed emails that still exist in contact lists and suggest exact cleanup actions
No parameter schema in public metadata yet.
send_emailSend via transactional or bulk stream. Supports HTML, text, or templates
Send via transactional or bulk stream. Supports HTML, text, or templates
No parameter schema in public metadata yet.
batch_sendSend up to 500 emails in one request
Send up to 500 emails in one request
No parameter schema in public metadata yet.
send_test_emailSend to a sandbox inbox for testing, with optional env defaults for inbox and sender
Send to a sandbox inbox for testing, with optional env defaults for inbox and sender
No parameter schema in public metadata yet.
list_templatesList all email templates
List all email templates
No parameter schema in public metadata yet.
get_templateGet template details including HTML/text body
Get template details including HTML/text body
No parameter schema in public metadata yet.
create_templateCreate a new template
Create a new template
No parameter schema in public metadata yet.
update_templateUpdate an existing template
Update an existing template
No parameter schema in public metadata yet.
delete_templateDelete a template
Delete a template
No parameter schema in public metadata yet.
render_react_emailRender a react-email component file (.tsx, .jsx, .js, .mjs) to HTML + plain text
Render a react-email component file (.tsx, .jsx, .js, .mjs) to HTML + plain text
No parameter schema in public metadata yet.
create_contactCreate a contact with email, custom fields, list membership
Create a contact with email, custom fields, list membership
No parameter schema in public metadata yet.
get_contactGet contact by UUID or email
Get contact by UUID or email
No parameter schema in public metadata yet.
update_contactUpdate contact fields, list membership, subscription status
Update contact fields, list membership, subscription status
No parameter schema in public metadata yet.
delete_contactDelete a contact
Delete a contact
No parameter schema in public metadata yet.
trigger_contact_eventTrigger automations for a contact
Trigger automations for a contact
No parameter schema in public metadata yet.
list_contact_listsList all contact lists
List all contact lists
No parameter schema in public metadata yet.
get_contact_listGet a single contact list
Get a single contact list
No parameter schema in public metadata yet.
create_contact_listCreate a new contact list
Create a new contact list
No parameter schema in public metadata yet.
update_contact_listRename a contact list
Rename a contact list
No parameter schema in public metadata yet.
delete_contact_listDelete a contact list
Delete a contact list
No parameter schema in public metadata yet.
manage_contact_fieldList, get, create, update, or delete custom contact fields
List, get, create, update, or delete custom contact fields
No parameter schema in public metadata yet.
import_contactsBulk import up to 50k contacts, or check import status
Bulk import up to 50k contacts, or check import status
No parameter schema in public metadata yet.
export_contactsStart contact export or check export status
Start contact export or check export status
No parameter schema in public metadata yet.
list_projectsList sandbox projects with inboxes
List sandbox projects with inboxes
No parameter schema in public metadata yet.
get_projectGet a single project
Get a single project
No parameter schema in public metadata yet.
manage_projectCreate, update, or delete a project
Create, update, or delete a project
No parameter schema in public metadata yet.
list_inboxesList all sandbox inboxes
List all sandbox inboxes
No parameter schema in public metadata yet.
get_inboxGet inbox details (credentials redacted by default)
Get inbox details (credentials redacted by default)
No parameter schema in public metadata yet.
manage_inboxCreate, update, clean, mark read, reset credentials, or delete
Create, update, clean, mark read, reset credentials, or delete
No parameter schema in public metadata yet.
get_messagesList messages in a sandbox inbox
List messages in a sandbox inbox
No parameter schema in public metadata yet.
get_messageGet message body in HTML/text/raw/EML format, with optional attachments
Get message body in HTML/text/raw/EML format, with optional attachments
No parameter schema in public metadata yet.
analyze_messageCombined spam score + HTML analysis + headers report
Combined spam score + HTML analysis + headers report
No parameter schema in public metadata yet.
forward_messageForward a test message to an email
Forward a test message to an email
No parameter schema in public metadata yet.
list_domainsList sending domains with DNS status
List sending domains with DNS status
No parameter schema in public metadata yet.
get_domainGet domain details including DNS records
Get domain details including DNS records
No parameter schema in public metadata yet.
manage_domainCreate or delete a sending domain
Create or delete a sending domain
No parameter schema in public metadata yet.
send_domain_setup_instructionsEmail DNS setup instructions to a colleague
Email DNS setup instructions to a colleague
No parameter schema in public metadata yet.
list_accountsList accounts or get one by ID
List accounts or get one by ID
No parameter schema in public metadata yet.
get_billing_usagePlan limits and current usage
Plan limits and current usage
No parameter schema in public metadata yet.
manage_account_accessList, remove, update permissions, view resources
List, remove, update permissions, view resources
No parameter schema in public metadata yet.
manage_api_tokenList, get, create, delete, or reset API tokens
List, get, create, delete, or reset API tokens
No parameter schema in public metadata yet.
Sponsors
Readme
mcpj-mailtrap
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
Details
- Repository
- github.com/pijusz/mcp-mailtrap
- Categories
- Communication & Messaging, Monitoring & Observability
- Package
mcpj-mailtrap- Transport
- STDIO
- Registry
- MCP registry, active