EngageLab Agent Email MCP Server

English | 简体中文

AIエージェントからのメールの送信、受信、返信 — Model Context Protocol を介して。

各エージェントには専用のメールボックスが与えられます。送信と受信の両方ができる実際のアドレスで、会話はスレッドにグループ化されるため、エージェントは文脈を把握できます。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は送信専用です。メールで会話をする必要があるエージェント（サポート、スケジューリング、承認）には受信トレイが必要です。

• 送受信 — エージェントは専用のメールボックスを所有し、後付けのパース用ウェブフックではありません

• スレッド対応 — 返信は会話にグループ化されるため、エージェントは完全な履歴を確認できます

• サンドボックスモード — 実際の人間にメールを送らずにエージェントのフローをテストできます

• 環境変数1つ — ローカル利用にOAuthの手間は不要。キーからリージョンを自動判定

ツール

クイックスタート

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

次にエージェントに依頼します:

メールボックスを一覧表示し、最初のメールボックスから bob@example.com に請求書が承認されたというメールを送信してください。

サポートボットの典型的なエージェントループ:

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

設定

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

トラブルシューティング

• list_mailboxes が空のリストを返す — アカウントにメールボックスがまだありません。EngageLabコンソールで作成してください（クイックスタートの手順2を参照）。エージェントはまだメールボックスを自己プロビジョニングできません。

• 401 / code 100101 — シークレットキーが間違っているか失効しています。ENGAGELAB_EMAIL_SECRET_KEY と、キーのリージョンプレフィックス（sk_sg_ / sk_tr_）が使用するエンドポイントと一致しているか確認してください。

• APIベースURLを特定できません — キーのリージョンプレフィックスが認識されていません。ENGAGELAB_EMAIL_BASE_URL を明示的に設定してください。

• 返信が新しい会話として表示される — reply_email（send_email ではなく）を使用して、In-Reply-Toヘッダーとスレッド化を維持してください。

ロードマップ

• ゼロ設定のリモート利用のためのホスト型MCP（OAuth）

• シークレットキーによるプログラムでのメールボックス作成

• check_new_messages のためのウェブフックプッシュ（ポーリングなし）

• 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