Resend Email
官方使用 Resend API 直接从你的编辑器发送电子邮件。
你可以用 Resend Email MCP 做什么?
- 发送和安排邮件 — 让你的助手发送 HTML 或纯文本邮件,并设置抄送/密送、回复地址、附件、标签和发送时间。
- 管理联系人和细分群组 — 创建、更新和移除联系人,管理细分群组成员资格和主题订阅,并运行 CSV 导入。
- 运行群发活动 — 创建、安排、发送或取消群发邮件,然后按事件类型和点击的链接查看收件人。
- 处理收件邮件和收件箱 — 列出并阅读收到的邮件、下载附件,以及管理收件箱会话、标签和草稿。
- 管理域名和抑制列表 — 创建、验证和配置发件人域名,并添加或移除抑制列表条目。
- 检查日志和用量 — 查看包含完整请求和响应正文的 API 请求日志,并检查账户用量和配额。
托管 MCP 服务器
npx add-mcp 'https://mcp.resend.com/mcp'可安装到 Claude Code、Codex、Cursor 等客户端
文档
Resend MCP Server
将您的 AI 代理连接到 Resend 平台。直接通过 Claude、Cursor 或 Claude Code 等任意 MCP 客户端发送和接收电子邮件,以及管理联系人、广播、域名等。
我们同时提供由 Resend 托管的远程 MCP 服务器和本地 MCP 服务器(此软件包)。
远程 MCP 服务器
Resend 在以下地址托管 MCP 服务器:
https://mcp.resend.com/mcp
连接任何支持远程服务器(Streamable HTTP)的 MCP 客户端。无需安装任何内容,也无需运行本地进程,因此它是 Claude 等 Web 客户端和托管代理平台的最佳选择。
连接时,客户端会打开浏览器窗口,让您登录 Resend 并通过 OAuth 批准访问。
Claude Code
claude mcp add --transport http resend https://mcp.resend.com/mcp
然后在 Claude Code 中运行 /mcp,并选择 resend 以完成 OAuth 登录。
Claude
在 Claude(网页版或桌面版)中,打开 Settings > Connectors > Add custom connector,然后输入:
https://mcp.resend.com/mcp
Cursor
打开命令面板,选择 "Cursor Settings" > "MCP" > "Add new global MCP server"。
{
"mcpServers": {
"resend": {
"url": "https://mcp.resend.com/mcp"
}
}
}
Codex
codex mcp add resend --url https://mcp.resend.com/mcp
Copilot
要在 VS Code 中使用 GitHub Copilot,请将以下内容添加到您的 settings.json:
{
"mcp": {
"servers": {
"resend": {
"type": "http",
"url": "https://mcp.resend.com/mcp"
}
}
}
}
Windsurf
{
"mcpServers": {
"resend": {
"serverUrl": "https://mcp.resend.com/mcp"
}
}
}
Warp
在 Warp 的 Settings 中,前往 Agents > MCP servers,然后点击 +Add 添加新服务器。
{
"resend": {
"serverUrl": "https://mcp.resend.com/mcp"
}
}
使用 API 密钥进行身份验证
如果客户端运行在无法通过浏览器登录的环境中(例如服务器、CI 或无头代理),请传递 Resend API 密钥 作为 Bearer 令牌,而不是使用 OAuth。
Claude Code:
claude mcp add --transport http resend https://mcp.resend.com/mcp --header "Authorization: Bearer re_xxxxxxxxx"
JSON 配置(Cursor、Windsurf 等),添加一个 Authorization 标头:
{
"mcpServers": {
"resend": {
"url": "https://mcp.resend.com/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
本地 MCP 服务器
托管服务器运行的代码与 NPM 上以开源形式提供的 resend-mcp 相同。如果您希望自行运行服务器,可以使用 npx 将其集成到任何受支持的 MCP 客户端中。您需要:
本地服务器支持两种传输模式:stdio(默认)和 HTTP。
选择下方您偏好的模式和客户端以开始使用。请记得将 re_xxxxxxxxx 替换为您的实际 API 密钥。
Stdio 传输(默认)
快速设置
为所有检测到或选定的代理和编辑器安装:
npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_xxxxxxxxx"
Claude Code
claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- npx -y resend-mcp
Codex
codex mcp add resend \
--env RESEND_API_KEY=re_xxxxxxxxx \
-- npx -y resend-mcp
Cursor
打开命令面板,选择 "Cursor Settings" > "MCP" > "Add new global MCP server"。
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Claude Desktop
打开 Claude Desktop 设置 > "Developer" 标签页 > "Edit Config"。
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Copilot
要在 VS Code 中使用 GitHub Copilot,请将以下内容添加到您的 settings.json:
{
"mcp": {
"servers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
}
Gemini CLI
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
OpenCode
将以下内容添加到您的 opencode.json 配置中:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"resend": {
"type": "local",
"command": ["npx", "-y", "resend-mcp"],
"enabled": true,
"environment": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Windsurf
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Devin
在 Devin 中,打开 Settings > Connections > MCP Servers,然后点击 Add a custom MCP。完整的分步说明请参阅 Devin 指南。
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx",
"SENDER_EMAIL_ADDRESS": "onboarding@resend.dev"
}
}
}
}
HTTP 传输
通过 HTTP 运行服务器,以用于远程或基于 Web 的集成,例如在您自己的隧道或反向代理后运行,而不是使用 Resend 的托管远程 MCP 服务器。在 HTTP 模式下,每个客户端都通过在 Authorization 标头中传递其 Resend API 密钥作为 Bearer 令牌进行身份验证。
启动服务器:
npx -y resend-mcp --http --port 3000
服务器将在 http://127.0.0.1:3000 上监听,并使用 Streamable HTTP 在 /mcp 提供 MCP 端点。
Claude Code
claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Cursor
打开命令面板,选择 "Cursor Settings" > "MCP" > "Add new global MCP server"。
{
"mcpServers": {
"resend": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
您也可以通过 MCP_PORT 环境变量设置端口:
MCP_PORT=3000 npx -y resend-mcp --http
作为库使用
HTTP 传输也会导出,因此可以嵌入其他服务,而不必通过 CLI 运行。每个连接的客户端都使用自身的 Resend API 密钥进行身份验证,该密钥以 Bearer 令牌形式传递。
import { runHttp } from 'resend-mcp/http';
// Options are optional — pass `senderEmailAddress` / `replierEmailAddresses`
// to set defaults. Binds the port and returns the Node http.Server, exposing
// the MCP endpoint at POST/GET/DELETE /mcp and a GET /health check.
const server = await runHttp({}, 3000);
默认情况下,服务器会执行仅限 localhost 的 Host 验证(防止 DNS 重绑定)。
部署在反向代理或负载均衡器后时,由于服务器已通过每个请求的 Bearer API 密钥受到保护,请将 host 设置为 0.0.0.0,
以免代理转发的 Host 和负载均衡器健康检查因 403 Invalid Host 而被拒绝:
const server = await runHttp({}, 3000, { host: '0.0.0.0' });
// or pin specific hostnames instead of disabling validation:
const server = await runHttp({}, 3000, { allowedHosts: ['mcp.example.com'] });
通过 CLI,这对应于 --host / --allowed-hosts(或 MCP_HOST /
MCP_ALLOWED_HOSTS)。
选项
您可以传递其他参数来配置本地服务器:
--key:您的 Resend API 密钥(仅限 stdio 模式,因为 HTTP 模式使用客户端传递的 Bearer 令牌)--sender:来自已验证域名的默认发件人电子邮件地址--reply-to:默认回复地址(可多次指定)--http:使用 HTTP 传输而非 stdio(默认:stdio)--port:使用--http时的 HTTP 端口(默认:3000,或使用MCP_PORT环境变量)--host:使用--http时用于 DNS 重绑定保护的主机(默认:127.0.0.1,或使用MCP_HOST)。设置为0.0.0.0可在代理/负载均衡器后禁用Host验证。--allowed-hosts:使用--http(或MCP_ALLOWED_HOSTS)时以逗号分隔的Host允许列表--allowed-file-dirs:本地文件附件和 CSV 导入可读取的目录列表,以逗号分隔(或使用MCP_ALLOWED_FILE_DIRS)。未设置时,stdio 不受限制;通过--http时始终禁用。
环境变量:
RESEND_API_KEY:您的 Resend API 密钥(stdio 必需;HTTP 可选,因为客户端会通过 Bearer 令牌传递密钥)SENDER_EMAIL_ADDRESS:来自已验证域名的默认发件人电子邮件地址(可选)REPLY_TO_EMAIL_ADDRESSES:以逗号分隔的回复地址(可选)MCP_PORT:使用--http时的 HTTP 端口(可选)MCP_HOST:使用--http时用于 DNS 重绑定保护的主机(可选)MCP_ALLOWED_HOSTS:使用--http时以逗号分隔的Host允许列表(可选)MCP_ALLOWED_FILE_DIRS:本地文件可读取的目录列表,以逗号分隔(可选)
[!NOTE] 如果您未提供发件人电子邮件地址,MCP 服务器会在每次调用工具时要求您提供。
[!WARNING]
send-email(attachments[].filePath)和create-contact-import(filePath)会读取本地文件。通过--http时,默认禁用此功能,以防远程客户端读取服务器磁盘;使用--allowed-file-dirs为特定目录启用此功能。在 stdio 模式下,设置--allowed-file-dirs,以防提示注入的代理附加您所选文件夹之外的文件。
MCP 服务器工具
Resend 的 MCP 服务器通过单一集成,为您的 AI 代理提供对整个 Resend 平台的原生访问。您可以使用自然语言管理电子邮件基础设施的各个方面。
- 电子邮件:发送、列出、获取、取消、更新、共享和批量发送电子邮件。检索投递和互动指标。支持 HTML、纯文本、附件(本地文件、URL 或 base64)、抄送/密送、回复地址、定时发送、标签、自定义标头、基于主题的发送和幂等键。
- 接收的电子邮件:列出并读取收到的电子邮件。列出并下载收到的电子邮件附件。
- 收件箱:创建、列出、获取、更新和移除收件箱。读取和更新收件箱代理设置。列出、搜索、获取、更新和移除会话,并添加、设置或移除其标签。列出和获取会话中的电子邮件,并通过附件和自定义标头回复或转发。创建、列出、更新和移除标签。创建、列出、获取、更新、移除和发送草稿,支持使用 base64 内容或 URL 添加附件。从收件箱发送新邮件以开始会话。在回复、转发、创建草稿、发送草稿和发送新邮件时支持幂等键。
- 模板:创建、列出、获取、更新、发布、复制和移除电子邮件模板。支持编写模板内容和
{{{VARIABLE}}}占位符。 - 联系人:创建、列出、获取、更新和移除联系人。管理细分成员资格、主题订阅和 CSV 联系人导入。支持自定义联系人属性。
- 广播:创建、发送、取消、复制、列出、获取、更新和移除广播活动。列出广播中被点击的链接,以及按事件类型(已发送、已投递、已打开、已点击、退信、投诉、取消订阅、已抑制)筛选的收件人。支持定时发送、个性化占位符和预览文本。
- 自动化:创建、列出、获取、更新、复制和移除自动化。查看自动化的运行记录。
- 事件:向联系人发送事件以触发自动化。创建、更新和移除事件定义。
- 域名:创建、列出、获取、更新、移除和验证发件人域名。配置跟踪、TLS 以及发送/接收功能。创建并验证域名声明。
- 细分:创建、列出、获取、更新和移除受众细分。
- 抑制列表:单独或批量列出、获取、添加和移除抑制列表条目。硬退信和垃圾邮件投诉会自动抑制;您也可以手动添加地址,以遵守拒绝联系请求。
- 主题:创建、列出、获取、更新和移除订阅主题。
- 联系人属性:创建、列出、获取、更新和移除自定义联系人属性。
- API 密钥:创建、列出、更新和移除 API 密钥。
- Webhooks:创建、列出、获取、更新和移除用于事件通知的 Webhook,并检查其投递历史记录——发送到 Webhook 的事件、单个事件的负载以及投递尝试记录。重新播放事件以排队进行另一次投递,并轮换 Webhook 的签名密钥。
- 日志:列出并检查 API 请求日志,包括完整的请求和响应正文。
- 用量:检索账户级别的用量和配额信息:电子邮件、联系人、细分、广播、AI 点数、自动化运行次数、域名和 API 速率限制。
- 编辑器:连接到(或断开与)Resend 控制面板中可视化编辑器的连接,并在协作处理广播和模板时读取草稿内容。
本地开发
- 克隆此项目并构建:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
- 要使用本地构建版本,请将
npx命令替换为本地构建版本的路径:
Claude Code(stdio):
claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- node ABSOLUTE_PATH_TO_PROJECT/dist/index.js
Claude Code(HTTP):
claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Cursor / Claude Desktop(stdio):
{
"mcpServers": {
"resend": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Cursor(HTTP):
{
"mcpServers": {
"resend": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
使用 MCP 客户端进行实时测试
开发时,您可以在另一个会话中编辑代码,同时在真实的 MCP 客户端会话中测试更改。
方法是:运行 tsc --watch,持续重新构建 dist/,然后让另一个 MCP 客户端从不同目录连接到构建后的 dist/index.js。要应用代码更改,请重启 MCP 客户端会话(MCP 服务器是长期运行的 stdio 进程,不会热重载)。
Claude Code 示例:
-
运行 TypeScript 监视器,以便在保存时自动重新构建:
pnpm tsc --watch -
在另一个目录中,创建一个指向构建输出的
.mcp.json:mkdir -p /tmp/mcp-test// /tmp/mcp-test/.mcp.json { "mcpServers": { "resend-dev": { "command": "node", "args": ["/absolute/path/to/resend-mcp/dist/index.js"], "env": { "RESEND_API_KEY": "re_xxxxxxxxx" } } } } -
从该目录启动 Claude Code 并使用 MCP 工具。修改代码后,启动新的 Claude Code 会话以加载新的构建版本。
同样的方法适用于任何 MCP 客户端——将测试环境与开发环境分开,使用 dist/index.js 的绝对路径,并在重新构建后重新连接 MCP 服务器。
使用 MCP Inspector 进行测试
**注意:**请确保已先构建项目(请参阅上方的本地开发部分)。
使用 Stdio 传输
-
设置你的 API 密钥:
export RESEND_API_KEY=re_your_key_here -
启动检查器:
pnpm inspector -
在浏览器中(检查器 UI):
- 选择 stdio(启动进程)。
- 命令:
node - 参数:
dist/index.js(或dist/index.js的完整路径) - 环境变量:
RESEND_API_KEY=re_your_key_here(如果已在同一终端中导出,则留空)。 - 点击 Connect,然后使用“List tools”验证服务器是否正常运行。
使用 HTTP 传输
-
在一个终端中启动 HTTP 服务器:
node dist/index.js --http --port 3000 -
在另一个终端中启动检查器:
pnpm inspector -
在浏览器中(检查器 UI):
- 选择 Streamable HTTP(连接到 URL)。
- URL:
http://127.0.0.1:3000/mcp - 添加自定义标头:
Authorization: Bearer re_your_key_here,并启用切换开关。 - 点击 Connect,然后使用“List tools”验证服务器是否正常运行。