de en es ja ko ru zh

mcpj-mailtrap

Name: mcpj-mailtrap
Author: pijusz

by pijusz

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

快速开始

1. 获取你的 API 令牌

从 Mailtrap API Tokens 获取 API 令牌。

2. 添加到 Claude Code

最小配置

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

完整配置

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

就这样。重启 Claude Code 后即可使用这些工具。

如果你安装了 Bun，也可以使用 bunx mcpj-mailtrap@latest。通过 npx 运行时需要 Node 18+。

Claude Desktop / Cursor

最小配置

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

完整配置

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

从 Releases 下载预构建的二进制文件：

平台	文件
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: Inbound Email MCP Server

工具（48 个）

分析

工具	描述
`get_stats`	发送统计 — 送达率、退信率、打开率、点击率、垃圾邮件率。可按域名、类别、ESP 或日期分组

邮件日志

工具	描述
`get_email_logs`	列出已发送邮件，支持按状态、流、日期过滤。基于游标的分页
`get_email_log`	单条消息详情，包含投递事件时间线
`get_suppressions`	列出被抑制的邮件地址（退信、垃圾邮件投诉、退订）
`delete_suppression`	重新允许向被抑制的地址发送邮件
`check_list_hygiene`	查找仍存在于联系人列表中的被抑制邮件地址，并建议精确的清理操作

发送

工具	描述
`send_email`	通过事务流或批量流发送。支持 HTML、纯文本或模板
`batch_send`	一次请求最多发送 500 封邮件
`send_test_email`	发送到沙箱收件箱进行测试，可通过环境变量设置默认收件箱和发件人

模板

工具	描述
`list_templates`	列出所有邮件模板
`get_template`	获取模板详情，包括 HTML/纯文本正文
`create_template`	创建新模板
`update_template`	更新现有模板
`delete_template`	删除模板
`render_react_email`	将 react-email 组件文件（`.tsx`、`.jsx`、`.js`、`.mjs`）渲染为 HTML + 纯文本

联系人

工具	描述
`create_contact`	创建联系人，包含邮箱、自定义字段、列表成员资格
`get_contact`	按 UUID 或邮箱获取联系人
`update_contact`	更新联系人字段、列表成员资格、订阅状态
`delete_contact`	删除联系人
`trigger_contact_event`	为联系人触发自动化流程
`list_contact_lists`	列出所有联系人列表
`get_contact_list`	获取单个联系人列表
`create_contact_list`	创建新的联系人列表
`update_contact_list`	重命名联系人列表
`delete_contact_list`	删除联系人列表
`manage_contact_field`	列出、获取、创建、更新或删除自定义联系人字段
`import_contacts`	批量导入最多 50k 个联系人，或检查导入状态
`export_contacts`	开始联系人导出或检查导出状态

邮件沙箱

工具	描述
`list_projects`	列出带收件箱的沙箱项目
`get_project`	获取单个项目
`manage_project`	创建、更新或删除项目
`list_inboxes`	列出所有沙箱收件箱
`get_inbox`	获取收件箱详情（默认隐藏凭据）
`manage_inbox`	创建、更新、清空、标记已读、重置凭据或删除
`get_messages`	列出沙箱收件箱中的消息
`get_message`	以 HTML/纯文本/原始/EML 格式获取消息正文，可选附件
`analyze_message`	综合垃圾邮件评分 + HTML 分析 + 邮件头报告
`forward_message`	将测试消息转发到指定邮箱

域名

工具	描述
`list_domains`	列出发送域名及 DNS 状态
`get_domain`	获取域名详情，包括 DNS 记录
`manage_domain`	创建或删除发送域名
`send_domain_setup_instructions`	将 DNS 设置说明通过邮件发送给同事

账户

工具	描述
`list_accounts`	列出账户或按 ID 获取单个账户
`get_billing_usage`	套餐限制和当前使用量
`manage_account_access`	列出、移除、更新权限，查看资源
`manage_api_token`	列出、获取、创建、删除或重置 API 令牌

配置

变量	必填	默认值	描述
`MAILTRAP_API_TOKEN`	是	—	来自 mailtrap.io/api-tokens 的通用 API 令牌
`MAILTRAP_SENDING_TOKEN`	否	`MAILTRAP_API_TOKEN`	用于事务流和批量流 `send.api` 请求的独立令牌
`MAILTRAP_ACCOUNT_ID`	否	自动发现	默认账户 ID
`MAILTRAP_DEFAULT_FROM_EMAIL`	否	—	`send_email` / `send_test_email` 的默认发件人邮箱
`MAILTRAP_TEST_INBOX_ID`	否	—	`send_test_email` 的默认沙箱收件箱 ID
`DEBUG`	否	—	启用调试日志

更新

使用 npx @latest（推荐）：你始终获得最新版本 — 无需手动更新。

使用二进制文件：服务器在启动时检查新版本，如果版本过旧则记录到 stderr：

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

检查你安装的版本：

mcpj-mailtrap --version

开发

需要 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

许可证

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

MailMCP
io.mailmcp
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Email Communication
1
MarleyFetch
com.marleyfetch
Let AI agents send email from your own Gmail, Microsoft 365 or SMTP inbox, with guardrails.
Email Communication
1
Email Inbox API + Sending by SendmuxOAuth
io.github.Sendmux
AI email inbox and sending tools with attachments, search, live events, and webhooks.
Email Communication
265
Send Email A
io.github.hal9ai
Send emails from natural language prompts.
Email App Automation
1

Related MCP Servers

Mailtrap Email Sending
Communication App Automation
mailtrap
A
license
A
quality
A
maintenance
Integrates with Mailtrap Email Platform to enable sending transactional emails via API.
Updated 18 hours ago (2026-10-09 17:16 UTC)
8
238 npm
65
MIT
Inbound Email MCP Server
Communication App Automation Developer Tools
inboundemail
F
license
B
quality
C
maintenance
Enables AI assistants to interact with the Inbound Email API to manage domains, endpoints, and email communications. Users can send or schedule emails, manage webhooks, and retrieve email threads through natural language commands.
Updated 9 days ago (2026-10-01 22:51 UTC)
14
2
-
Mailosaur MCP
Email Testing & QA Tools
MrNewDelhi
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.
Updated 5 months ago (2026-05-18 05:59 UTC)
29
MIT
Mailjet MCP Serverofficial
Email Marketing
mailgun
A
license
Not graded
quality
B
maintenance
Enables AI agents to interact with Mailjet's contact, campaign, segmentation, statistics, and workflow APIs for managing email marketing operations through natural language.
Updated 2 months ago (2026-08-12 13:01 UTC)
165 npm
13
Apache 2.0