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

npm version

将您的 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 控制面板中可视化编辑器的连接,并在协作处理广播和模板时读取草稿内容。

本地开发

  1. 克隆此项目并构建:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. 要使用本地构建版本,请将 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 示例:

  1. 运行 TypeScript 监视器,以便在保存时自动重新构建:

    pnpm tsc --watch
    
  2. 在另一个目录中,创建一个指向构建输出的 .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"
          }
        }
      }
    }
    
  3. 从该目录启动 Claude Code 并使用 MCP 工具。修改代码后,启动新的 Claude Code 会话以加载新的构建版本。

同样的方法适用于任何 MCP 客户端——将测试环境与开发环境分开,使用 dist/index.js 的绝对路径,并在重新构建后重新连接 MCP 服务器。

使用 MCP Inspector 进行测试

**注意:**请确保已先构建项目(请参阅上方的本地开发部分)。

使用 Stdio 传输

  1. 设置你的 API 密钥:

    export RESEND_API_KEY=re_your_key_here
    
  2. 启动检查器:

    pnpm inspector
    
  3. 在浏览器中(检查器 UI):

    • 选择 stdio(启动进程)。
    • 命令: node
    • 参数: dist/index.js(或 dist/index.js 的完整路径)
    • 环境变量: RESEND_API_KEY=re_your_key_here(如果已在同一终端中导出,则留空)。
    • 点击 Connect,然后使用“List tools”验证服务器是否正常运行。

使用 HTTP 传输

  1. 在一个终端中启动 HTTP 服务器:

    node dist/index.js --http --port 3000
    
  2. 在另一个终端中启动检查器:

    pnpm inspector
    
  3. 在浏览器中(检查器 UI):

    • 选择 Streamable HTTP(连接到 URL)。
    • URL: http://127.0.0.1:3000/mcp
    • 添加自定义标头:Authorization: Bearer re_your_key_here,并启用切换开关。
    • 点击 Connect,然后使用“List tools”验证服务器是否正常运行。