Skip to main content
Glama
pijusz

mcpj-mailtrap

by pijusz

快速开始

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

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