Resend Email MCP

resend-email-mcp

最も充実した Resend MCP サーバー — Resend API（メール、ドメイン、連絡先、ブロードキャスト、テンプレート、セグメント、トピック、Webhook、ログ）を完全にカバーし、他の Resend MCP にはない独自のデバッグ／診断レイヤーも備えています。配信可能性の分析、DNS のトラブルシューティング、メールのライフサイクルの調査、バウンスの説明、アカウント監査に対応します。

Claude Code、Cursor、Claude Desktop、その他すべての MCP クライアントで動作します。

---

この MCP を選ぶ理由

	resend-email-mcp	公式 resend-mcp	最小限の MCP
送信／一括送信／予約送信	✅	✅	一部対応
ドメイン、連絡先、ブロードキャスト、テンプレート、セグメント、トピック、Webhook	✅	✅	❌
API リクエストのログツール	✅	❌	❌
デバッグレイヤー（診断、分析、調査、説明、監査）	✅ 7 ツール	❌	❌
読み取り専用セーフティモード	✅	❌	❌
新しいエンドポイント用の未加工データへのアクセス手段	✅	❌	❌
冪等性キーのサポート	✅	一部対応	❌

75 個のツール＋2 個のリソース。

---

クイックスタート

1. Resend API キーを取得する

https://resend.com/api-keys で作成します。

2. MCP クライアントに追加する

Claude Code（CLI）

claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxx -- npx -y resend-email-mcp

Cursor / Claude Desktop / 汎用（mcp.json / claude_desktop_config.json）

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-email-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxx",
        "RESEND_FROM": "Acme <[email protected]>"
      }
    }
  }
}

設定ファイルの場所：

• Claude Desktop（Windows）： %APPDATA%\Claude\claude_desktop_config.json
• Claude Desktop（macOS）： ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor： ~/.cursor/mcp.json（またはプロジェクトごとの .cursor/mcp.json）

クライアントを再起動し、「[email protected] にテストメールを送信して」または「Resend アカウントを監査して」と尋ねてください。

---

設定

環境変数	必須	説明
RESEND_API_KEY	✅	Resend API キー
RESEND_FROM	–	from が省略された場合の send_email のデフォルト送信元（検証済みドメインである必要があります）
RESEND_REPLY_TO	–	デフォルトの Reply-To アドレス
RESEND_READONLY	–	true にすると、変更を伴うすべてのツール（送信／作成／更新／削除）がブロックされます。本番環境を安全に調査できます
RESEND_ATTACHMENTS_DIR	–	send_email の localPath 添付ファイルを制限するディレクトリ。未設定の場合、ディスクからの読み込みは無効（安全なデフォルト。パストラバーサルはブロックされます）
RESEND_BASE_URL	–	API のベース URL を上書きします（デフォルトは https://api.resend.com）。https が必須です（localhost の場合のみ http 可）
RESEND_MAX_RETRIES	–	429／5xx に対する再試行回数（デフォルトは 3）

---

ツール

メール

send_email · send_batch_emails · get_email · list_emails · update_email · cancel_email · preview_email

send_email は、base64 の content、公開された path（URL）、または localPath（ディスク上のファイル。自動的に読み込まれ、base64 にエンコードされます。RESEND_ATTACHMENTS_DIR が設定されている場合のみ有効で、そのディレクトリ内に制限されます）による添付ファイルを受け付けます。preview_email はメッセージをドライランし、最終的な送信元の解決、添付ファイルのサイズ確認、警告の提示を行います。メールは送信されません。

添付ファイル（送信・受信）

list_email_attachments · get_email_attachment · list_received_emails · get_received_email · list_received_attachments · get_received_attachment

ドメイン

create_domain · get_domain · list_domains · update_domain · delete_domain · verify_domain

API キー

create_api_key · list_api_keys · delete_api_key

ブロードキャスト

create_broadcast · get_broadcast · list_broadcasts · update_broadcast · send_broadcast · delete_broadcast

連絡先

create_contact · get_contact · list_contacts · update_contact · delete_contact · get_contact_topics · update_contact_topics · list_contact_segments · add_contact_to_segment · remove_contact_from_segment

連絡先のプロパティ

create_contact_property · get_contact_property · list_contact_properties · update_contact_property · delete_contact_property

セグメント

create_segment · get_segment · list_segments · delete_segment · list_segment_contacts

テンプレート

create_template · get_template · list_templates · update_template · delete_template · publish_template · duplicate_template

トピック

create_topic · get_topic · list_topics · update_topic · delete_topic

Webhook

create_webhook · get_webhook · list_webhooks · update_webhook · delete_webhook

ログ

list_logs · get_log

🔍 デバッグと診断（このツールの差別化要因）

ツール	機能
diagnose_domain	すべての DNS レコード（SPF／DKIM／DMARC）を調査し、不足している項目と修正方法を報告します
analyze_deliverability	最近の送信を集計し、配信率／バウンス率／苦情率と健全性の判定を提示します
inspect_email	1 通のメールのライフサイクル全体を時系列で表示し、問題を検出します
explain_bounce	バウンスを分類（ハード／ソフト／ブロック）し、推奨する対応を提示します
audit_account	ドメイン、キー、配信可能性を一括でヘルスチェックします
search_logs	ステータス／パス／受信者で API ログをスマートに絞り込み、失敗を見つけます
test_send	Resend のサンドボックスアドレスを使って、配信／バウンス／苦情を安全にシミュレートします

エスケープハッチ

resend_raw — 専用ツールでまだラップされていない Resend エンドポイントを呼び出します。

リソース

ツールに加えて、このサーバーは読み取り専用の MCP リソースを 2 つ公開しており、クライアントはツール呼び出しを消費せずにアカウントのコンテキストを取得できます。

URI	内容
resend://account	ドメインと API キーのスナップショット
resend://domains	検証ステータス付きのすべての送信ドメイン

すべてのツールには MCP ヒント（readOnlyHint、destructiveHint、idempotentHint）が注釈されているため、クライアントは安全な操作と確認が必要な操作を表示できます。

---

プロンプトの例

• 「acme.com が検証されていない理由を診断してください。」 → diagnose_domain
• 「今週のメール送信の健全性はどうですか？」 → analyze_deliverability
• 「メール re_abc123 に何が起きましたか？」 → inspect_email
• 「そのメールがバウンスした理由と、対処方法を教えてください。」 → explain_bounce
• 「Resend の設定に問題があるようです。すべて確認してください。」 → audit_account
• 「『beta』セグメントにローンチニュースレターを送信してください。」 → create_broadcast + send_broadcast

---

安全なテスト

Resend のサンドボックスアドレスを使用します（レピュテーションへの影響はありません）。

• [email protected] — 配信をシミュレートします
• [email protected] — ハードバウンスをシミュレートします
• [email protected] — スパム苦情をシミュレートします

または、test_send を実行してから、返された ID を使って inspect_email を実行します。

RESEND_READONLY=true を有効にすると、送信や削除を行うリスクなく、本番アカウントを調べられます。

---

トラブルシューティング

この MCP は自身をデバッグできるように構築されています。問題が発生した場合は、推測するのではなく診断ツールを利用してください。

症状／エラー	考えられる原因	実行するコマンド
validation_error: from domain is not verified	from／RESEND_FROM のドメインが検証されていません	list_domains → diagnose_domain（不足している DNS レコードと修正方法を表示）→ verify_domain
メールは送信されるが、届かない	配信可能性／レピュテーションの問題	analyze_deliverability を実行してから、サンプル ID を使って inspect_email を実行します
missing_api_key／invalid_api_key（HTTP 401）	RESEND_API_KEY が未設定、または誤っています	.env を確認し、resend.com/api-keys でキーを作成します
restricted_api_key／not_authorized（403）	キーの権限が送信のみに制限されているか、1 つのドメインに限定されています	full_access キーを使用します（list_api_keys で確認）
rate_limit_exceeded（429）	リクエストが多すぎます	クライアントはバックオフを伴って自動再試行します。リクエスト量を減らしてください
daily_quota_exceeded	プランの送信上限に達しました	プランをアップグレードするか、リセットをお待ちください
特定のメールがバウンスした	受信者が無効、またはブロックされています	explain_bounce（ハード／ソフト／ブロックを分類し、対応方法を提示）
「設定に何か問題がありますか？」	—	audit_account（一括ヘルスチェック）
理由不明のリクエスト失敗	—	only_errors: true を指定して search_logs

このサーバーが返すエラーにはすべて、HTTP ステータス、Resend のエラー名、実行可能な対応を示す ヒントの行が含まれます。

---

ローカル開発

git clone https://github.com/helbertparanhos/resend-email-mcp.git
cd resend-email-mcp
npm install
npm run build
cp .env.example .env   # add your RESEND_API_KEY
npm run inspector      # opens the MCP Inspector against the built server

---

ライセンス

MIT © Helbert Paranhos / Strat Academy

Model Context Protocol を使用して構築されています。Resend とは提携していません。