resend/resend-mcp

The official MCP server to send emails and interact with Resend

Resend MCP Server – クイック概要

概要 – AI 搭載の「MCP」クライアント(Claude、Cursor、Copilot、または MCP (Message-Control-Protocol) に対応したあらゆるツール)が、Resend メール配信プラットフォームと直接通信できるようにする小さな Node-JS サービス(resend-mcp NPM パッケージとして利用可能)です。実質的に、言語モデルをフル機能のメール自動化アシスタントに変えることができます:メール送信、連絡先管理、ブロードキャスト実行、受信メッセージ処理など。

重要性 – このブリッジがない場合、プロンプト内でカスタム API 呼び出しを記述するか、別のスクリプトを作成する必要があります。MCP サーバーは、安定した言語モデルフレンドリーなコマンドセット(README の MCP Server Tools リスト)を公開しており、モデルは自然言語の指示でこれらを呼び出すことで、メール運用マネージャーとして機能できます。


2つの実行方法

モード 仕組み 使用タイミング
リモート MCP サーバー (Resend ホスト) クライアントを https://mcp.resend.com/mcp に向けます。クライアントが OAuth 用のブラウザを開くか、Resend API キーを指定します。 セットアップが最も速く、ローカルプロセスを動かしたくない Web ベースのエージェント(Claude、Cursor など)に最適です。
ローカル MCP サーバー (本パッケージ) npx resend-mcp (デフォルトは stdio) または npx resend-mcp --http でサーバーを自分で実行します。Resend API キーと、オプションでデフォルトの送信元アドレスを提供します。 完全な制御が必要な場合、ファイアウォールの背後で実行する場合、またはプライベートな CI/エージェント環境に統合する場合に必要です。

どちらのモードも同じツールセットを公開します。唯一の違いはトランスポート(stdio か Streamable HTTP か)です。


はじめに (ローカル, stdio – デフォルト)

# 検出された MCP クライアントにサーバーを登録するワンライナー
npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_XXXXX"

re_XXXXX をあなたの Resend API キーに置き換えてください。

その後、Claude Code のようなクライアントでは、単に以下を実行するだけです:

claude mcp add resend -e RESEND_API_KEY=re_XXXXX -- npx -y resend-mcp

クライアントがサーバーを子プロセスとして起動し、stdio 経由で通信を行い、メールツールの使用を開始できます。


HTTP モード (ヘッドレスエージェントやカスタムプロキシに便利)

# ポート 3000 でリッスンするサーバーを起動
npx -y resend-mcp --http --port 3000

クライアントは http://127.0.0.1:3000/mcp に接続し、自身の Resend API キーを含む Bearer ヘッダーを送信します。

サーバーを別の Node サービスに埋め込むことも可能です:

import { runHttp } from 'resend-mcp/http';
const server = await runHttp({ senderEmailAddress: "me@mydomain.com" }, 3000);

サーバーはデフォルトで Host ヘッダーを検証します(DNS リバインディング保護)。リバースプロキシの背後にある場合は、--host 0.0.0.0 または --allowed-hosts を設定してください。


MCP サーバーでできること (ツールリスト)

  • Emails – 送信、一覧表示、キャンセル、更新、一括送信、ファイル添付(ローカル、URL、base64)、スケジュール、タグ、カスタムヘッダー、冪等性。
  • Received mail – 受信メッセージの一覧表示、添付ファイルのダウンロード。
  • Templates – {{{VARIABLE}}} プレースホルダーを使用した CRUD 操作。
  • Contacts & Segments – アドレス帳管理、CSV インポート、カスタムプロパティ、トピック購読。
  • Broadcasts & Automations – キャンペーン作成、開封/クリック追跡、スケジュール、プレビュー、複製。
  • Events & Topics – 自動化のトリガー、購読トピックの管理。
  • Domains – 検証、追跡/TLS 設定、クレーム管理。
  • Suppressions – バウンス/苦情エントリの追加/削除、手動の配信停止リスト。
  • Webhooks – CRUD、配信履歴の表示、イベントのリプレイ、署名シークレットのローテーション。
  • Logs & Usage – API リクエストログの検査、クォータ/使用統計の表示。
  • Editor integration – Resend のビジュアルエディタに接続して共同ドラフト編集。

これらはすべて MCP ツール として公開されており、LLM が単純な JSON 形式のペイロードで呼び出せるため、メールワークフローの自動化がモデルの能力の自然な拡張となります。


設定オプション

フラグ / 環境変数 用途
--key / RESEND_API_KEY stdio モード用の API キー(HTTP モードはクライアントの Bearer トークンから取得)。
--sender / SENDER_EMAIL_ADDRESS デフォルトの「From」アドレス(検証済みドメインに属している必要があります)。
--reply-to / REPLY_TO_EMAIL_ADDRESSES デフォルトの返信先アドレス(複数可)。
--http HTTP トランスポートに切り替え。
--port / MCP_PORT HTTP モードのポート(デフォルト 3000)。
--host / MCP_HOST HTTP のホスト検証(デフォルト 127.0.0.1)。
--allowed-hosts / MCP_ALLOWED_HOSTS プロキシの背後にある場合の Host ヘッダーのホワイトリスト。
--allowed-file-dirs / MCP_ALLOWED_FILE_DIRS サーバーがローカル添付ファイルを読み取れるディレクトリ(HTTP では設定しない限り無効)。

誰がこれを使うのか?

  • AI エージェントを構築する開発者:生の HTTP 呼び出しを書かずに、トランザクションメールやマーケティングメールを送信する必要がある場合。
  • Claude、Cursor、Copilot などの MCP 対応エディタを使用するチーム:LLM にニュースレター、サポートチケット、自動返信を管理させたい場合。
  • 企業:コンプライアンスのためにブリッジを自社ホストしたり、企業プロキシの背後で実行したい場合。

一般的なクライアント向けのクイックチートシート

// Cursor / Claude Desktop (stdio)
{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": { "RESEND_API_KEY": "re_XXXXX" }
    }
  }
}
// HTTP モード (任意のクライアント)
{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": { "Authorization": "Bearer re_XXXXX" }
    }
  }
}

結論 – resend-mcp は、最新の LLM ベースのアシスタントが Resend のメールプラットフォームをファーストクラスのコマンド駆動型サービスとして扱えるようにする、薄いオープンソースの接着層です。ホストされたエンドポイント経由でも、自己実行型の Node サーバー経由でも利用可能です。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト