MCP Mailtrap

MCP server for the Mailtrap email platform — analytics, sending, contacts, sandbox

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-mailtrap": {
      "command": "npx",
      "args": [
        "-y",
        "mcpj-mailtrap"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (46)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Mailtrap.

get_stats

Sending statistics — delivery, bounce, open, click, spam rates. Group by domain, category, ESP, or date

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

Documentation Overview

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

Terminal

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

Full

Terminal

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

config.json

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

Full

config.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:

Terminal

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Communication View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

2.9k

Package downloads in the last 30 days.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Mailtrap

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "mcp-mailtrap": { "command": "npx", "args": ["-y", "mcp-mailtrap"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/mcp-mailtrap?style=directory)](https://allmcps.com/mcp/mcp-mailtrap)

HTML Embed

<a href="https://allmcps.com/mcp/mcp-mailtrap"><img src="https://allmcps.com/api/badge/mcp-mailtrap?style=directory" alt="MCP Mailtrap on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity5/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to MCP Mailtrap →Install in Claude Desktop Install in Cursor Install in VS Code

MCP Mailtrap

MCP server for the Mailtrap email platform — analytics, sending, contacts, sandbox

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-mailtrap": {
      "command": "npx",
      "args": [
        "-y",
        "mcpj-mailtrap"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (46)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Mailtrap.

get_stats

Sending statistics — delivery, bounce, open, click, spam rates. Group by domain, category, ESP, or date

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

Documentation Overview

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

Terminal

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

Full

Terminal

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

config.json

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

Full

config.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:

Terminal

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Communication View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

2.9k

Package downloads in the last 30 days.

Last commit

4mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Mailtrap

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "mcp-mailtrap": { "command": "npx", "args": ["-y", "mcp-mailtrap"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/mcp-mailtrap?style=directory)](https://allmcps.com/mcp/mcp-mailtrap)

HTML Embed

<a href="https://allmcps.com/mcp/mcp-mailtrap"><img src="https://allmcps.com/api/badge/mcp-mailtrap?style=directory" alt="MCP Mailtrap on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

53Quality signal: Good · 53/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity5/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to MCP Mailtrap →Install in Claude Desktop Install in Cursor Install in VS Code