Email sending MCP 💌

Resend MCP サーバー

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 の設定で 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 クライアントに統合できます。次の準備が必要です。

• API キーを作成する
• ドメインを検証する

ローカルサーバーでは、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": "[email protected]"
      }
    }
  }
}

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 経由で実行する代わりに、別のサービスに組み込むことができます。接続する各クライアントは、Bearer トークンとして渡す独自の Resend API キーで認証します。

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 キー（stdio モードのみ。HTTP モードではクライアントから Bearer トークンとして渡されます）
• --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 使用時のカンマ区切りの Host 許可リスト（または MCP_ALLOWED_HOSTS）
• --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：ローカルファイルの読み取りを許可するディレクトリ（カンマ区切り、省略可能）

メモ

送信元メールアドレスを指定しない場合、MCP サーバーはツールを呼び出すたびに、そのアドレスを指定するよう求めます。

警告

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、返信先、スケジュール設定、タグ、カスタムヘッダー、トピックベースの送信、冪等性キーに対応しています。
• 受信メール：受信メールを一覧表示して読み取れます。受信メールの添付ファイルを一覧表示してダウンロードできます。
• 受信トレイ：受信トレイの作成、一覧表示、取得、更新、削除を行えます。受信トレイのエージェント設定を読み取り、更新できます。スレッドの一覧表示、検索、取得、更新、削除や、ラベルの追加、設定、削除を行えます。スレッド内のメールを一覧表示、取得し、添付ファイルやカスタムヘッダーを付けて返信または転送できます。ラベルの作成、一覧表示、更新、削除を行えます。添付ファイル付きの下書きの作成、一覧表示、取得、更新、削除、送信を行えます。受信トレイから新しいメールを送信してスレッドを開始できます。返信、転送、下書きの作成と送信、新しいメールの送信時に冪等性キーを使用できます。
• テンプレート：メールテンプレートの作成、一覧表示、取得、更新、公開、複製、削除を行えます。テンプレートコンテンツの作成と {{{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

2. ローカルビルドを使用するには、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. Inspector を起動します。

   pnpm inspector
   

3. ブラウザー（Inspector UI）で、次の操作を行います。

   • stdio（プロセスを起動）を選択します。
   • コマンド： node
   • 引数： dist/index.js（または dist/index.js のフルパス）
   • 環境変数： RESEND_API_KEY=re_your_key_here（同じターミナルですでにエクスポートしている場合は、空欄のままにします）。
   • 接続をクリックし、「ツール一覧」を使ってサーバーが動作していることを確認します。

HTTP トランスポートを使う

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

   node dist/index.js --http --port 3000
   

2. 別のターミナルで Inspector を起動します。

   pnpm inspector
   

3. ブラウザー（Inspector UI）で、次の操作を行います。

   • Streamable HTTP（URL に接続）を選択します。
   • URL： http://127.0.0.1:3000/mcp
   • カスタムヘッダー Authorization: Bearer re_your_key_here を追加し、切り替えスイッチを有効にします。
   • 接続をクリックし、「ツール一覧」を使ってサーバーが動作していることを確認します。