How do I install MCP Mailtrap?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does MCP Mailtrap need an API key?

No required environment variable is listed on this record.

What transport does MCP Mailtrap use?

MCP Mailtrap runs locally over stdio.

When was MCP Mailtrap last checked?

Last checked 2026-11-10. MCP server for the Mailtrap email platform — analytics, sending, contacts, sandbox

MCP Mailtrap MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.pijusz-mcp-mailtrap -- npx -y mcpj-mailtrap@0.1.4

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.pijusz-mcp-mailtrap": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.4
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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 [email protected] \
  -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": "[email protected]",
        "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"

Tools (46)

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 filtered by status, stream, date range, recipient, sender, subject, or category. Cursor-based pagination
`get_email_log`	Single message detail with delivery events timeline
`get_suppressions`	List suppressed emails (bounces, spam complaints, unsubscribes) with the IDs `delete_suppression` needs
`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 typecheck  # tsc
bun run build      # standalone binary
bun run inspect    # MCP Inspector
bun run check      # biome format + lint

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install MCP Mailtrap?

Does MCP Mailtrap need an API key?

What transport does MCP Mailtrap use?

When was MCP Mailtrap last checked?

Documentation

Quick Start

1. Get Your API Token

2. Add to Claude Code

Claude Desktop / Cursor

Tools (46)

Analytics

Email Logs

Sending

Templates

Contacts

Email Sandbox

Domains

Accounts

Configuration

Updates

Development

License