pijusz avatar

Mcp Mailtrap

pijusz/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 tools

Public 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@latest if you have Bun. Requires Node 18+ when running via npx.

Claude Desktop / Cursor

Minimal


View the full README on GitHub

Details

Repository
github.com/pijusz/mcp-mailtrap
Categories
Communication & Messaging, Monitoring & Observability
Package
mcpj-mailtrap
Transport
STDIO
Registry
MCP registry, active

More from pijusz

Related Communication & Messaging MCP servers

View all
1cnghockey avatarSats4AI - Bitcoin-Powered AI Toolscnghockey/sats4ai-mcp-server40+ Lightning-paid AI tools for agents: calls, SMS, fax, voice, translation. No signup, no keys.2stars
2creativestefan avatarMailbridgecreativestefan/mailbridge-mcpConnect your AI assistant to email — read, search, send, and organise via IMAP/SMTP.2stars
3platfone-com avatarPlatfoneplatfone-com/mcpVirtual phone numbers for AI agents — rent numbers in 200+ countries, receive SMS.0stars
4stonematt avatarMcp Obsidian Clistonematt/mcp-obsidian-cliSave chat notes from Claude Desktop to your vault — MCP on Obsidian CLI. Keep what matters.2stars
5adelaidasofia avatarMulti-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, tokenadelaidasofia/google-workspace-mcpMulti-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token-efficient, macOS…1stars
6adelaidasofia avatarmacOS-only MCP server that exposes iMessage chatadelaidasofia/imessage-mcpmacOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an…1stars