io.github.pijusz/mcp-mailtrap MCP Server

The io.github.pijusz/mcp-mailtrap MCP server provides access to the Mailtrap email platform with functionality described as analytics, email logs, contacts, and sandbox testing. It is intended to be used via natural language through an MCP client and is built with Bun + TypeScript, with compatibility mentioned for Claude, Cursor, and any MCP client.

🛠️ Key Features

Analytics
Email logs
Contacts
Sandbox testing
Natural-language access
Built with Bun + TypeScript

🚀 Use Cases

Retrieve or review Mailtrap analytics
Inspect email logs
Manage contacts
Test email sending in a sandbox environment

⚡ Developer Benefits

Works with Claude, Cursor, and other MCP clients
Installable as an MCP server after providing a Mailtrap API token

⚠️ Limitations

Requires a Mailtrap API token from Mailtrap API Tokens to use.

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

bash

claude mcp add mailtrap -e MAILTRAP_API_TOKEN=your_token -- npx mcpj-mailtrap

Full

bash

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

json

{
  "mcpServers": {
    "mailtrap": {
      "command": "npx",
      "args": ["-y", "mcpj-mailtrap@latest"],
      "env": {
        "MAILTRAP_API_TOKEN": "your_token"
      }
    }
  }
}

Full

json

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

bash

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):

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:

code

[mcpj-mailtrap] Update available: v0.2.0 (current: v0.1.0)

Check your installed version:

bash

mcpj-mailtrap --version

Development

Requires Bun.

bash

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

io.github.pijusz/mcp-mailtrap MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

mcpj-mailtrap

Quick Start

1. Get Your API Token

2. Add to Claude Code

Claude Desktop / Cursor

Tools (48)

Analytics

Email Logs

Sending

Templates

Contacts

Email Sandbox

Domains

Accounts

Configuration

Updates

Development

License

Install

Related servers