AgenticEmail: AIエージェント用メール
AgenticEmailは、エージェントに実際のメールアドレスを持つインボックスを提供します。単なる送信専用APIとは異なり、各インボックスは送受信の両方が可能です。受信メールはWebhookまたはWebSocketストリームを介して解析済みJSONとして届きます。エージェントがメールアドレスで到達可能である必要があり、単に送信できるだけでは不十分な場合に、このスキルを使用してください。
一般的なトリガー: エージェントがサードパーティサービスに登録する必要がある、確認コードやOTPを受信する、メールで通知を受け取る、サポートやアウトリーチワークフローを実行する、人間や他のエージェントとメールを交換する。
セットアップ
- https://app.agenticemail.dev でAPIキー(
am_で始まります)を取得します。無料枠には実際のインボックス、送信、受信、Webhookが含まれます。 - エクスポート:
export AGENTICEMAIL_API_KEY=am_... - 以下の統合パスから選択します。すべて
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/webhooks | Webhookを登録。ボディ { "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