Which integrations are available for this server?

Provides tools for interacting with Mailtrap's API, enabling analytics, email logs, sending transactional and bulk emails, managing templates, contacts, sandbox testing, domains, and account settings.

How do I use mcpj-mailtrap?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcpj-mailtrap send a test email to my sandbox inbox" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

mcpj-mailtrap

by pijusz

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

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

{
  "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"
      }
    }
  }
}

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"

Related MCP server: Inbound Email MCP Server

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

MailMCP
io.mailmcp
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Email Communication
1
Email Inbox API + Sending by SendmuxOAuth
io.github.Sendmux
AI email inbox and sending tools with attachments, search, live events, and webhooks.
Email Communication
273
Send Email A
io.github.hal9ai
Send emails from natural language prompts.
Email App Automation
11
send16-mcp B
io.github.spruikco
Email for AI agents: send mail, manage contacts, automations & webhooks. Zero-DNS first send.
Email App Automation
792

Related MCP Servers

Mailtrap Email Sending
Communication App Automation
mailtrap
A
license
A
quality
A
maintenance
Integrates with Mailtrap Email Platform to enable sending transactional emails via API.
Updated 10 hours ago (2026-09-15 08:58 UTC)
8
360 npm
65
MIT
Inbound Email MCP Server
Communication App Automation Developer Tools
inboundemail
F
license
B
quality
D
maintenance
Enables AI assistants to interact with the Inbound Email API to manage domains, endpoints, and email communications. Users can send or schedule emails, manage webhooks, and retrieve email threads through natural language commands.
Updated 6 months ago (2026-03-04 15:23 UTC)
14
2
-
Mailosaur MCP
Email Testing & QA Tools
MrNewDelhi
A
license
B
quality
D
maintenance
Enables interaction with Mailosaur email and SMS testing services, allowing message management, server configuration, file downloads, spam analysis, and TOTP code retrieval via natural language.
Updated 4 months ago (2026-05-18 05:59 UTC)
29
MIT
Mailjet MCP Serverofficial
Email Marketing
mailgun
A
license
Not graded
quality
A
maintenance
Enables AI agents to interact with Mailjet's contact, campaign, segmentation, statistics, and workflow APIs for managing email marketing operations through natural language.
Updated a month ago (2026-08-12 13:01 UTC)
80 npm
11
Apache 2.0