Mailgi

Mailgi

AI エージェント向けメール。 すべてのエージェントに実際に使えて配信可能なメールボックスが割り当てられ、REST 経由で完結します。SMTP や IMAP のクライアントは必要ありません。

エージェントは認証不要の POST を 1 回送信して登録すると、認証コードを受け取ったり、返信したり、メールを保存したりできるアドレスを取得します。受信は無料です。外部へのメール送信は従量課金制です。ホスト型 MCP サーバーも https://api.mailgi.xyz/mcp で利用できます。

• ウェブサイト：https://www.mailgi.xyz
• ガイド：https://www.mailgi.xyz/guides.html （認証コード、サポート用受信トレイ、OpenAI Agents SDK、LangChain）
• ドキュメント：https://www.mailgi.xyz/docs.html
• API ドキュメント：https://api.mailgi.xyz/docs
• エージェント向けリファレンス：https://www.mailgi.xyz/SKILL.md

このリポジトリについて

パス	内容	ステータス
packages/typescript	TypeScript SDK と mailgi CLI — npm @mailgi/mailgi	公開済み
packages/python	Python SDK — PyPI mailgi	予定
apps/ui	メールボックスを調べるための React 開発者 UI	開発ツール
spec	openapi.json — 各 SDK が準拠する契約	—

API とメールインフラストラクチャは、別の非公開リポジトリにあります。

クイックスタート

npm install -g @mailgi/mailgi

mailgi register --label my-agent          # saves to ~/.mailgi/config.json
mailgi send --agent <handle> --to [email protected] --subject Hi --body Hello
mailgi inbox --agent <handle>

または、コードから：

import { AgentMailboxClient } from "@mailgi/mailgi";

const client = AgentMailboxClient.withApiKey("https://api.mailgi.xyz", process.env.MAILGI_API_KEY!);
await client.sendMail({ to: ["[email protected]"], subject: "Hi", textBody: "Hello" });

MCP サーバー

Mailgi は、REST API と 1 対 1 で対応するホスト型 MCP サーバー（Streamable HTTP）を https://api.mailgi.xyz/mcp で提供しています。利用開始に API キーは不要です。エージェントが register_agent を呼び出すと、専用のアドレスとキーを取得できます。

claude mcp add --transport http mailgi https://api.mailgi.xyz/mcp

Cursor、Claude Desktop、その他のクライアント向けの設定：https://www.mailgi.xyz/mcp.html。 server.json は、公式 MCP Registry に xyz.mailgi/mailgi として登録する際のエントリーです。

このリポジトリでの作業

npm install                      # installs all workspaces
npm run build                    # builds every package
npm test                         # runs every package's tests
npm run dev -w @mailgi/ui        # developer UI on :5173

npm が混乱しないよう、ワークスペースはルートの package.json に明示的に記載し、グロブは使用していません。これにより、packages/python のような Node.js 以外のパッケージも並行して配置できます。

SDK はそれぞれ独立したバージョンを使用するため、リリースタグはパッケージごとに名前空間を分けています。たとえば、ts-sdk-v0.2.0、py-sdk-v0.1.0 です。

ライセンス

MIT