MepMail

@mepmail/mcp

ローカル MCP クライアント（Claude Desktop、Claude Code、Cursor、Codex、および stdio に対応するすべてのクライアント）向けの、公式 MepMail MCP サーバーです。チーム API キーを使用して、公開 REST API（Resend 互換の通信形式）経由で MepMail インスタンスを操作します。また、Correio エージェントキーを使ってメールボックスを操作できます。受信トレイを読み、返信を下書きとして保存し、送信したり（または所有者に承認を依頼したり）できます。

MepMail は、https://api.mepmail.dev/mcp でホスト型 MCP サーバー（OAuth、インストール不要）も提供しています。このパッケージは、設定からローカルサーバーを起動するクライアント向けです。ツール名と結果の形式はホスト型サーバーと同じですが、対象範囲はその一部（読み取り、送信、連絡先のツール（22 個））です。連絡先以外の書き込み機能（セグメント、トピック、一斉配信、テンプレート、Webhook、ドメイン、API キー）とチーム選択機能は、ホスト型サーバーでのみ利用できます。

ガイド：https://docs.mepmail.dev/mcp · パッケージ：https://docs.mepmail.dev/packages · npm では @mepmail/mcp として公開されています。

Node.js 20 以降が必要です。

クイックスタート

1. MepMail ダッシュボードの API keys で API キーを作成します。フルアクセスキーを使用し、必要に応じてエージェントが送信する送信者ドメインにスコープを設定してください。送信アクセスキーは /emails に限定されるため、連絡先ツール（list_contacts、get_contact、create_contact、update_contact、delete_contact）では restricted_api_key による 403 エラーが発生します。
2. クライアントにサーバーを追加します。

Claude Desktop（claude_desktop_config.json）— および同じ形式の設定を使うクライアント（Cursor：mcp.json）：

{
  "mcpServers": {
    "mepmail": {
      "command": "npx",
      "args": ["-y", "@mepmail/mcp"],
      "env": {
        "MEPMAIL_API_KEY": "ms_...",
        "MEPMAIL_BASE_URL": "https://api.mepmail.dev"
      }
    }
  }
}

Claude Code：

claude mcp add mepmail -e MEPMAIL_API_KEY=ms_... -e MEPMAIL_BASE_URL=https://api.mepmail.dev -- npx -y @mepmail/mcp

Correio のメールボックス — Correio の Settings → Agents でエージェントキーを作成します。1 つのメールボックスには mmb_... を、選択した複数のメールボックスに対して読み取り、下書き、必要に応じて送信の権限を設定するには、「Connect an agent to several mailboxes」を選び mmt_... の認証情報を作成します。その後、同じサーバーにキーを追加します（メールボックスのみを利用する場合、API キーは省略できます）。

claude mcp add mepmail -e MEPMAIL_MAIL_TOKEN=mmt_... -- npx -y @mepmail/mcp

環境

MEPMAIL_API_KEY と MEPMAIL_MAIL_TOKEN の少なくとも一方を設定してください。

変数	必須	デフォルト	意味
MEPMAIL_API_KEY	送信ツールで必要	—	チーム API キー（ms_...）。Bearer として、お使いのインスタンスにのみ送信されます。
MEPMAIL_BASE_URL	いいえ	https://api.mepmail.dev	お使いのインスタンスの API URL。
MEPMAIL_MAIL_TOKEN	メールボックスツールで必要	—	Correio エージェントキー（mmb_... または mmt_...）。Bearer として、ダッシュボードのオリジンにのみ送信されます。
MEPMAIL_MAIL_ORIGIN	いいえ	https://mepmail.dev	ダッシュボードの応答先。

ツール（22）

メールの送信と管理：

• send_email — トランザクションメールを1通送信または予約します（cc/bcc/reply_to、タグ、添付ファイル、トピック単位の送信に対応）。
• send_email_batch — 1回の呼び出しで最大100通のメールを送信します。
• get_email、list_emails — ステータスとタイムライン（last_event：delivered、bounced、complained、...）。
• update_email、cancel_email — 予約済みメールを再予約またはキャンセルします。
• get_email_insights — メールごとのベストプラクティスレポートとスコアを取得します。
• get_deliverability、get_usage — 一括処理の前にアカウントの状態を確認します。

オーディエンスとアカウント：

• create_contact、update_contact、delete_contact（GDPR/LGPD に準拠したデータ消去には erase=true を指定）、get_contact、list_contacts — セグメントフィルターに対応します。
• list_domains、get_domain — DNS レコードと検証状態を取得します。
• list_broadcasts、get_broadcast。
• list_templates、get_template。
• list_webhooks、list_suppressions。

Correio メールボックス（MEPMAIL_MAIL_TOKEN を使用。ホスト型の https://api.mepmail.dev/mcp/correio と同じ5つのツール）：

• mailbox_list_accounts — キーでアクセス可能なメールボックスを、権限およびデフォルトのメールボックスとともに一覧表示します。
• mailbox_list_messages、mailbox_read_message — 受信トレイ、下書き、送信済みメールを対象とします。チームの認証情報を使う場合は mailbox を指定します。一覧表示は1ページずつ、受信日時の新しい順です。返された nextCursor を cursor として渡し、hasMore が false になるまで続けてください（カーソルは同じメールボックス、フォルダー、フィルターでのみ有効です）。フィルターはページを切り出す前にサーバー上で適用されます。指定できるのは query（単語、「引用符で囲んだフレーズ」、de:/from:、para:/to:、assunto:/subject:、tem:anexo、depois:/antes:）、from、subject、unread、after、before です。limit は最大100（検索時は50）です。ページ取得中に届いたメールは1ページ目より前に表示されるため、確認するには最初からやり直してください。ページが短い、または空であっても、メールボックスにメッセージが存在しない証拠にはなりません。また、検索では新着メールの反映が約1分遅れる場合があるインデックスを参照します。日付については、一覧の after/before は並び順の基準時刻（到着時刻、またはスヌーズしたメッセージが戻った時刻、下書きの場合は最終編集時刻）を使います。検索では到着時刻を使い、スヌーズ中のメッセージも検索対象になりますが、一覧では戻ってくるまで表示されません。
• mailbox_get_attachment — mailbox_read_message で取得したメッセージ ID、リビジョン、インデックスを指定して、添付ファイルを1つ取得します。ファイル名、バイトデータ、sha256 が返されます。MEPMAIL_MAIL_DOWNLOAD_DIR が設定されている場合は、その場所にファイルが保存されます（上書きはされません）。未設定の場合は、最大512 KiBの content_base64 として返されます。
• mailbox_save_draft — 新規作成、編集、返信、転送を行います。送信元にはそのメールボックスのアドレスと署名が使われます。attachments で { filename, content_base64 } を指定してファイルを追加するか、MEPMAIL_MAIL_UPLOAD_DIR 内のファイルに対して { path } を指定できます（それ以外のローカルパスは読み取られません）。keep_attachments で、編集中の下書きまたは転送元メッセージから保持するファイルを選択します（デフォルトではすべて保持され、返信では保持されません）。上限は10ファイル、各256 KiB、合計約700 KiBです。ファイルは下書きリクエスト内でのみ送信されるため、下書きを破棄してもファイルは残りません。
• mailbox_send_draft — 送信権限があれば送信します。権限がない場合は、オーナーに承認リクエストが送られます（awaiting_approval）。

すべてのツール結果は、{ notice, untrusted_data } という1つの JSON ブロックのエンベロープです。これにより、エージェントはチームが作成した文字列とツールの出力を区別でき、受信者のデータを指示として扱わないようにできます。

送信時の安全な再試行

send_email と send_email_batch は、任意のトップレベルの idempotency_key を受け付けます。同じ送信操作を再試行する場合は、同じキーと同一の引数を使用してください。新しい操作には新しいキーを生成してください。サーバーはこのキーを HTTP の Idempotency-Key ヘッダーとして渡します。これはメールヘッダーでもメッセージのフィールドでもありません。

キーはチームごとに管理され、24 時間保持されます。完了済みの操作を再試行すると、元の結果が返されます。異なる引数でキーを再利用すると競合が返されます。処理中の操作でも競合が返される場合があります。不完全な予約は 10 分後に復旧できます。これらの制限はサーバーに適用されるため、この契約に対応した API バージョンを使用してください。

エージェントの検出

• マシンカタログ：https://mepmail.dev/.well-known/ai-catalog.json
• エージェント向け認証ガイド：https://mepmail.dev/auth.md
• API ＋エラー＋レート制限：https://docs.mepmail.dev

ライセンス

MIT