Resend Email

官方

直接從編輯器使用 Resend API 發送電子郵件。

你可以用 Resend Email MCP 做什麼?

  • 傳送與排程電子郵件 — 請助理傳送 HTML 或純文字電子郵件,並設定 CC/BCC、回覆地址、附件、標籤與排程。
  • 管理聯絡人與區隔 — 建立、更新及移除聯絡人,管理區隔成員資格與主題訂閱,並執行 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 等網頁用戶端和託管代理平台。

連線時,用戶端會開啟瀏覽器視窗,讓您登入 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 token 傳入,而非使用 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 執行伺服器,以供遠端或網頁整合使用,例如透過您自己的通道或反向代理,而非使用 Resend 的託管遠端 MCP 伺服器。在 HTTP 模式下,每個用戶端都會在 Authorization 標頭中傳入自己的 Resend API 金鑰作為 Bearer token,以進行驗證。

啟動伺服器:

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 token 進行驗證。

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 token)
  • --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 token 傳入)
  • 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)、CC/BCC、回覆地址、排程、標籤、自訂標頭、依主題傳送,以及冪等性金鑰。
  • 已接收的電子郵件:列出並讀取收到的電子郵件。列出並下載已接收電子郵件的附件。
  • 收件匣:建立、列出、取得、更新及移除收件匣。讀取並更新收件匣代理程式設定。列出、搜尋、取得、更新及移除對話串,並新增、設定或移除其標籤。列出並取得對話串中的電子郵件,並以附件和自訂標頭回覆或轉寄。建立、列出、更新及移除標籤。建立、列出、取得、更新、移除及傳送草稿,附件可使用 base64 內容或 URL。從收件匣傳送新電子郵件以開始對話串。回覆、轉寄、建立草稿、傳送草稿及傳送新電子郵件時支援冪等性金鑰。
  • 範本:建立、列出、取得、更新、發布、複製及移除電子郵件範本。支援撰寫範本內容和 {{{VARIABLE}}} 佔位符。
  • 聯絡人:建立、列出、取得、更新及移除聯絡人。管理區隔成員資格、主題訂閱和 CSV 聯絡人匯入。支援自訂聯絡人屬性。
  • 廣播:建立、傳送、取消、複製、列出、取得、更新及移除廣播行銷活動。列出廣播中被點擊的連結,以及依事件類型分類的收件者(已傳送、已送達、已開啟、已點擊、退信、已檢舉、已取消訂閱、已抑制)。支援排程、個人化佔位符和預覽文字。
  • 自動化:建立、列出、取得、更新、複製及移除自動化。檢視自動化的執行記錄。
  • 事件:傳送事件以觸發聯絡人的自動化。建立、更新及移除事件定義。
  • 網域:建立、列出、取得、更新、移除及驗證寄件者網域。設定追蹤、TLS,以及傳送/接收功能。建立並驗證網域宣告。
  • 區隔:建立、列出、取得、更新及移除受眾區隔。
  • 抑制清單:列出、取得、新增及移除抑制清單項目,可逐筆或批次處理。系統會自動抑制硬退信和垃圾郵件檢舉;若要遵守拒絕聯絡的要求,請手動新增地址。
  • 主題:建立、列出、取得、更新及移除訂閱主題。
  • 聯絡人屬性:建立、列出、取得、更新及移除自訂聯絡人屬性。
  • API 金鑰:建立、列出、更新及移除 API 金鑰。
  • Webhook:建立、列出、取得、更新及移除事件通知用的 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(啟動程序)。
    • Command: node
    • Args: dist/index.js(或 dist/index.js 的完整路徑)
    • Env: 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」確認伺服器正常運作。