AgenticEmail: AIエージェント用メールスキル

AIエージェントに実際のメールインボックスを提供し、送受信・返信・MCP対応・オプションのエンドツーエンド暗号化を実現します。

AgenticEmail: AIエージェント用メールスキル とは?

AgenticEmailは、AIエージェントが自身のメールアドレスを持ち、リアルタイムでメールの送受信・返信を行えるようにするスキルです。単なる送信専用APIとは異なり、各インボックスはWebhookまたはWebSocketストリームを通じて受信メールを解析済みJSONとして受け取ります。このスキルは、エージェントがサードパーティサービスへの登録、確認コードやOTPの受信、メール通知の取得、サポートやアウトリーチワークフローの実行、人間や他のエージェントとのメール交換が必要な場合に最適です。Claude、Cursor、Vercel AI SDKなどのMCP対応エージェント用にホスト型MCPサーバーを提供し、CLI、TypeScript SDK、Python SDKもサポート。さらに、オプションのエンドツーエンド暗号化により、エージェント間通信の秘密鍵がサーバーに渡らず、安全にメール内容を保護できます。

対応✓Claude Code~Codex CLI✓Cursor✓Antigravity
npx skills add AgenticEmail/agenticemail-skill

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AgenticEmail: AIエージェント用メール

AgenticEmailは、エージェントに実際のメールアドレスを持つインボックスを提供します。単なる送信専用APIとは異なり、各インボックスは送受信の両方が可能です。受信メールはWebhookまたはWebSocketストリームを介して解析済みJSONとして届きます。エージェントがメールアドレスで到達可能である必要があり、単に送信できるだけでは不十分な場合に、このスキルを使用してください。

一般的なトリガー: エージェントがサードパーティサービスに登録する必要がある、確認コードやOTPを受信する、メールで通知を受け取る、サポートやアウトリーチワークフローを実行する、人間や他のエージェントとメールを交換する。

セットアップ

  1. https://app.agenticemail.dev でAPIキー(am_で始まります)を取得します。無料枠には実際のインボックス、送信、受信、Webhookが含まれます。
  2. エクスポート: export AGENTICEMAIL_API_KEY=am_...
  3. 以下の統合パスから選択します。すべて https://api.agenticemail.dev を呼び出します。

パスを選ぶ

  • ホスト型MCPサーバー(Claude、Cursor、Vercel AI SDKなどのMCP対応エージェントに推奨)。https://api.agenticemail.dev/mcp にAPIキーをBearerトークンとして接続します。エージェントは以下のツールを直接利用できます: create_inbox、list_inboxes、list_threads、get_thread、list_messages、get_message、send_message、reply_to_message。
  • CLI(npm i -g agenticemail-cli)、シェル駆動のエージェント向け。
  • SDK(TypeScriptは npm i agenticemail、Pythonは pip install 'agenticemail[e2e]')、コード向け。

MCPクライアント設定

HTTPネイティブクライアント(Claude、Cursorなど、ストリーミング可能HTTPに対応):

{
  "mcpServers": {
    "agenticemail": {
      "type": "http",
      "url": "https://api.agenticemail.dev/mcp",
      "headers": { "Authorization": "Bearer ${AGENTICEMAIL_API_KEY}" }
    }
  }
}

Stdioのみのクライアントは、ブリッジを使用:

npx mcp-remote https://api.agenticemail.dev/mcp \
  --header "Authorization: Bearer $AGENTICEMAIL_API_KEY"

コアフロー: 作成、送信、受信、返信

CLI:

INBOX=$(agenticemail inboxes create --username assistant | jq -r .id)
agenticemail messages send "$INBOX" --to [email protected] \
  --subject "Hello" --text "Sent by an agent."
agenticemail messages list "$INBOX" --limit 5
agenticemail messages reply "$INBOX" <msgId> --text "On it."
agenticemail wait-for-message "$INBOX" --timeout 300

TypeScript SDK:

import { AgenticEmail } from "agenticemail";
const client = new AgenticEmail({ apiKey: process.env.AGENTICEMAIL_API_KEY! });

const inbox = await client.inboxes.create({ username: "assistant" });
await client.messages.send(inbox.id, {
  to: ["[email protected]"],
  subject: "Hello",
  text: "Sent by an agent.",
});
const { data } = await client.messages.list(inbox.id, { limit: 5 });
const msg = await client.messages.get(inbox.id, data[0].id);
await client.messages.reply(inbox.id, msg.id, { text: "Thanks." });

Python SDK:

from agenticemail import AgenticEmail
client = AgenticEmail(api_key=os.environ["AGENTICEMAIL_API_KEY"])
inbox = client.inboxes.create(username="assistant")
client.messages.send(inbox.id, to=["[email protected]"], subject="Hello", text="...")
for m in client.messages.list(inbox.id, limit=5).data:
    print(m.subject)

REST API(SDKを使用しない場合)

ベースURL https://api.agenticemail.dev、ヘッダー Authorization: Bearer $AGENTICEMAIL_API_KEY。

メソッドパス目的
POST/v1/inboxesインボックスを作成。ボディ { "username": "assistant" }(オプション)。
GET/v1/inboxesインボックス一覧。
POST/v1/inboxes/{id}/messages送信。ボディ { "to": ["[email protected]"], "subject": "...", "text": "..." }。
GET/v1/inboxes/{id}/messages一覧表示。クエリ limit、cursor。
GET/v1/inboxes/{id}/messages/{msgId}解析済みメッセージを取得。
POST/v1/inboxes/{id}/messages/{msgId}/replyスレッド内で返信。
POST/v1/webhooksWebhookを登録。ボディ { "url": "...", "eventTypes": ["message.received"] }。

すべてのメッセージオブジェクトには encrypted ブール値が含まれており、クライアントは復号化が必要かどうかを認識できます。

受信メールの受信

新しいメールが届いた瞬間にエージェントに届くようWebhookを登録:

agenticemail webhooks create --url https://your-app/hook \
  --event-types message.received

各イベントには、解析済みの送信者、件名、テキスト、HTML、添付ファイルが含まれます。エージェントがすでに実行中の場合は、同じイベントのWebSocketストリームも利用可能です(agenticemail events tail)。

エンドツーエンド暗号化(オプション)

エージェント間メール向けに、AgenticEmailはオプトインのエンドツーエンド暗号化を提供します。秘密鍵はクライアント側(SDKまたはCLI)で生成・保持され、サーバーには決して送信されないため、プラットフォームは内容を読み取れません。CLIで agenticemail keys generate <inbox> を実行し、次に agenticemail keys publish <inbox> を実行すると有効になり、その後 messages send と messages get は自動的に暗号化・復号化を行います。SDKでは、クライアント構築時に e2e アイデンティティを渡します:

import { AgenticEmail, generateIdentity } from "agenticemail";
const client = new AgenticEmail({
  apiKey: process.env.AGENTICEMAIL_API_KEY!,
  e2e: { identity: generateIdentity(), autoPublish: true },
});

以下は、その機能範囲と制限を正直に述べたものです:

  • オプトインであり、公開鍵を発行した2つのAgenticEmailインボックス間でのみ機能します。デフォルトは平文です。
  • 秘密鍵はクライアント側のみに存在し、サーバーには決して到達しないため、プラットフォームもそのクラウドプロバイダも暗号化された内容を読むことはできません。
  • 外部アドレス(Gmail、企業サーバーなど)への送信は、公開鍵が存在しないため平文にフォールバックします。
  • ルーティングメタデータ(From、To、タイミング、サイズ)は、SMTPの要件により可視のままです。
  • 秘密鍵を紛失すると、古い暗号化メールは復元できません。サーバーが鍵を保持しないことの代償です。

ドキュメント

完全なドキュメント: https://agenticemail.dev/docs

関連スキル