Resend Email

公式

エディタから直接Resend APIを使ってメールを送信します。

Resend Email MCPで何ができますか?

  • メールの送信と予約 — アシスタントに依頼して、CC/BCC、返信先、添付ファイル、タグ、送信予約を指定した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 などのウェブベースのクライアントや、ホスト型エージェントプラットフォームに最適です。

接続すると、クライアントによってブラウザーウィンドウが開き、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、ヘッドレスエージェントなど)で実行する場合は、OAuth の代わりに Resend API キー を Bearer トークンとして渡します。

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 の 2 つのトランスポートモードに対応しています。

以下から希望するモードとクライアントを選んで開始してください。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 トランスポート

Resend のホスト型リモート MCP サーバーを使う代わりに、独自のトンネルやリバースプロキシの背後などで、リモートまたはウェブベースの連携向けに HTTP 経由でサーバーを実行します。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 やロードバランサーのヘルスチェックが 403 Invalid Host で拒否されないよう、host を 0.0.0.0 に設定します。

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 キー(HTTP モードではクライアントから Bearer トークンを使用するため、stdio モードのみ)
  • --sender: 認証済みドメインのデフォルト送信元メールアドレス
  • --reply-to: デフォルトの返信先メールアドレス(複数指定可能)
  • --http: stdio の代わりに HTTP トランスポートを使用(デフォルト: stdio)
  • --port: --http 使用時の HTTP ポート(デフォルト: 3000、または MCP_PORT 環境変数)
  • --host: --http 使用時の DNS リバインディング対策用ホスト(デフォルト: 127.0.0.1、または MCP_HOST)。プロキシまたはロードバランサーの背後で Host 検証を無効にするには、0.0.0.0 に設定します。
  • --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)、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/ を継続的に再ビルドし、別のディレクトリから、ビルドされた dist/index.js を別の MCP クライアントに指定します。コードの変更を反映するには、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. ブラウザー(Inspector UI)で次の操作を行います。

    • stdio(プロセスを起動)を選択します。
    • Command: node
    • Args: dist/index.js(または dist/index.js へのフルパス)
    • Env: RESEND_API_KEY=re_your_key_here(同じターミナルで既にエクスポートしている場合は空欄のままにします)。
    • Connect をクリックし、「List tools」を使ってサーバーが動作していることを確認します。

HTTP トランスポートの使用

  1. 1つ目のターミナルで HTTP サーバーを起動します。

    node dist/index.js --http --port 3000
    
  2. 別のターミナルでインスペクターを起動します。

    pnpm inspector
    
  3. ブラウザー(Inspector UI)で次の操作を行います。

    • Streamable HTTP(URL に接続)を選択します。
    • URL: http://127.0.0.1:3000/mcp
    • カスタムヘッダーを追加します:Authorization: Bearer re_your_key_here。次にトグルを有効にします。
    • Connect をクリックし、「List tools」を使ってサーバーが動作していることを確認します。