io.github.pijusz/mcp-mailtrap

Official registry Productivity

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package mcpj-mailtrap

Claude Code

claude mcp add mcp-mailtrap -- npx -y mcpj-mailtrap@0.1.4

JSON configuration (Claude Desktop, Cursor, VS Code)

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents

mcpj-mailtrap
Quick Start
Tools (46)
Configuration
Updates
Development
License

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

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

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:

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

Frequently asked questions

What is io.github.pijusz/mcp-mailtrap?

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

How do I install io.github.pijusz/mcp-mailtrap?

It runs on your machine. In Claude Code: claude mcp add mcp-mailtrap -- npx -y mcpj-mailtrap@0.1.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.pijusz/mcp-mailtrap need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.pijusz/mcp-mailtrap open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.pijusz/mcp-mailtrap?

It is published by pijusz. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.

Server details

Listed in: Official MCP Registry
Publisher: pijusz
Category: Productivity
Runs: Local
GitHub stars: ★ 3
License: MIT
Language: TypeScript
Last commit: Oct 22, 2026
Open issues: 0
Version: 0.1.4
Published: Mar 23, 2026

io.github.pijusz/mcp-mailtrap

Similar servers

VibeView Drive cloud iOS, Android, Apple TV, Android TV and Roku devices to verify app changes.
Avenbridge Hosted MCP knowledge base: businesses forward emails and docs; buyers query them over MCP.
Wisemation Finds companies and people to write to, checks they fit, saves the emails your agent wr...
Pombus Email boxes for AI agents. Read, draft, send and triage mail.
mailmcp Your mailboxes in ChatGPT and Claude: Gmail, iCloud, Fastmail, any IMAP. Passwords stay...
Agent Data Tools: Company, compliance and checks 31 tools: OFAC sanctions, counterparty checks, company, domain, email. 25 free calls.
Agent Data Tools 566 agent tools: chain data, prices, sanctions, web, PDF. 25 free calls, then from $0.002.
Liliphant Liliphant turns every meeting into connected knowledge, decisions, and actionable insig...

Productivity