engagelab-email

EngageLab Agent Email MCP サーバー

英語 | 簡体字中国語

EngageLab Email の公式プロジェクトです。

このリポジトリでは、ローカル stdio MCP サーバーを配布しています。ホストされた OAuth または HTTP MCP エンドポイントは提供していません。以下のインストールコマンドを使って、ローカルで実行してください。

Model Context Protocol を通じて、AI エージェントがメールを送信、受信、返信できます。

各エージェントには専用のメールボックスが割り当てられます。送信と受信の両方ができる実際のアドレスで、会話はスレッドにまとめられるため、エージェントは文脈を把握できます。Claude Desktop、Claude Code、Cursor、Cowork、および MCP 互換のあらゆるクライアントで利用できます。

{
  "mcpServers": {
    "engagelab-email": {
      "command": "npx",
      "args": ["-y", "@engagelabemail/mcp"],
      "env": { "ENGAGELAB_EMAIL_SECRET_KEY": "sk_sg_your_key" }
    }
  }
}

選ばれる理由

多くのメール API は送信専用です。サポート、スケジュール調整、承認など、メールで会話する必要があるエージェントには、受信トレイが必要です。

• 送受信 — エージェントは後付けの解析用 Webhook ではなく、専用のメールボックスを持ちます
• スレッド対応 — 返信は会話ごとにまとめられるため、エージェントは履歴全体を確認できます
• サンドボックスモード — 実際の人にメールを送ることなく、エージェントのフローをテストできます
• 環境変数は 1 つ — ローカルで使う場合、OAuth の手続きは不要です。リージョンはキーから推定されます

ツール

	ツール	内容
検出	list_mailboxes	メールボックスを一覧表示します。最初に呼び出して ID を取得してください
送信	send_email	新規メール（text/html、cc/bcc、添付ファイル、サンドボックス）
	reply_email	メッセージに返信します。宛先とスレッドは自動的に推定されます
受信	list_inbound_messages	受信メール。メールボックスやキーワードで絞り込めます
	get_message	UID でメッセージの詳細を取得します
	check_new_messages	新着メールを 1 回だけ確認します
スレッド	list_threads / get_thread / list_thread_messages	会話を閲覧します

クイックスタート

Smithery / MCPB

ローカル stdio 配布用の MCPB バンドルをビルドします。

npm run build:mcpb

バンドルは dist/engagelab-agent-email.mcpb に生成され、Smithery publishing からアップロードできます。

公式 MCP レジストリ

EngageLab Agent Email は公式 MCP レジストリにも登録されています。レジストリを利用するクライアントは、サーバー名 io.github.Metaverse-Cloud/engagelab-email で検索できます。基盤となる npm パッケージは引き続き @engagelabemail/mcp です。

1. シークレットキーを取得します。 EngageLab アカウントを作成し、コンソールでキーを生成します（形式は sk_sg_xxx です。プレフィックスでリージョンが決まります）。またはCLIを使用します。engagelab-email-cli login を実行すると、ブラウザー経由でキーを作成できます。

2. メールボックスを作成します。 コンソールでエージェント用のメールボックスを作成します（共有サブドメインはすぐに利用できます。カスタムドメインには DNS 検証が必要です）。プログラムからのメールボックス作成は今後対応予定です。list_mailboxes の結果が空の場合は、トラブルシューティングを参照してください。

3. サーバーを登録します。

Claude Desktop — 上記の JSON ブロックを claude_desktop_config.json に追加します。

Claude Code:

claude mcp add engagelab-email \
  -e ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_your_key \
  -- npx -y @engagelabemail/mcp

続いて、エージェントに次のように依頼します。

メールボックスを一覧表示してから、最初のメールボックスを使って [email protected] に請求書が承認された旨のメールを送信してください。

サポートボットでの一般的なエージェントのループ：

check_new_messages()            → [messageUids]
get_message(uid)                → body, attachments
list_thread_messages(threadId)  → full conversation context
reply_email(uid, { text: ... }) → response lands in the same thread

設定

環境変数	必須	説明
ENGAGELAB_EMAIL_SECRET_KEY	はい	sk_ で始まるシークレットキー
ENGAGELAB_EMAIL_BASE_URL	いいえ	API のベース URL を上書きします。キーのリージョンから推定されます：sg → シンガポール、tr → トルコ

制限：メッセージあたり最大 10 個の添付ファイル、合計 10MB（ツールスキーマでは Base64 エンコード）。

トラブルシューティング

• list_mailboxes が空のリストを返す — アカウントにメールボックスがまだありません。EngageLab コンソールで作成してください（クイックスタートのステップ 2 を参照）。エージェントはまだメールボックスを自動で作成できません。
• 401 / code 100101 — Secret Key が間違っているか、無効化されています。ENGAGELAB_EMAIL_SECRET_KEY と、キーのリージョンプレフィックス（sk_sg_ / sk_tr_）が使用するエンドポイントと一致していることを確認してください。
• API のベース URL を特定できない — キーのリージョンプレフィックスが認識されていません。ENGAGELAB_EMAIL_BASE_URL を明示的に設定してください。
• 返信が新しい会話として表示される — send_email ではなく reply_email を使い、In-Reply-To ヘッダーとスレッドを維持してください。

ロードマップ

• ホスト型 MCP（OAuth）による、設定不要のリモート利用
• Secret Key によるプログラムからのメールボックス作成
• check_new_messages の Webhook プッシュ（ポーリング不要）
• URL ベースの添付ファイル参照（コンテキスト内で base64 を使用しない）

ソースから実行

git clone https://github.com/Metaverse-Cloud/engagelab-email-mcp
cd engagelab-email-mcp
npm install && npm run build
ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_xxx node dist/index.cjs

関連項目

• EngageLab Agent Email CLI — ターミナルから同じメールボックスを利用し、エージェント向けに --json 形式で出力します
• EngageLab Node SDK / Python SDK — コードからメールを送信します

ライセンス

MIT