Skip to main content
Glama
pijusz

mcpj-mailtrap

by pijusz

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

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables sending transactional emails through GetMailer from AI assistants. Supports email operations, template management, domain verification, analytics, suppression lists, and batch email jobs.
    14
    10
    MIT
  • 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.
    29
    MIT

View all related MCP servers

Related MCP Connectors

  • AI email inbox and sending tools with attachments, search, live events, and webhooks.

  • Email for AI agents: send mail, manage contacts, automations & webhooks. Zero-DNS first send.

  • Email for AI agents — send, receive as a webhook, manage domains, templates, routing.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pijusz/mcp-mailtrap'

If you have feedback or need assistance with the MCP directory API, please join our Discord server