AIエージェントが使い捨てのメールボックスを作成し、メッセージの読み取りや、サインアップフローにおける認証コードの自動抽出を行うことを可能にします。
別名 blockonomics/emptyinbox-me, emptyinbox-mcp
- スター
- 4
- ツール
- 11
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.5.0
- 最終コミット
- 2026年11月13日
- ライセンス
- —
EmptyInbox MCPとは
AIエージェントが使い捨てのメールボックスを作成し、メッセージの読み取りや、サインアップフローにおける認証コードの自動抽出を行うことを可能にします。 11個のツールを提供しており、create_inbox, list_inboxes, list_messagesなどがあります。
プロジェクトのREADMEから生成された概要
EmptyInbox MCP server について
EmptyInboxは、AIエージェントが自動化タスクのために使い捨てのメールアドレスを管理するための手段を提供します。このMCP serverを使用すると、エージェントは新しいインボックスの生成、受信メッセージの読み取り、および認証コードやアクションリンクなどの特定データの抽出が可能になります。人間の手作業を介さずに、サインアップフローやワンタイムパスワードの要件を処理できるように設計されています。
ユーザーはClaude Code経由、または標準的なMCPクライアントの設定にnpxコマンドを追加することでセットアップできます。サーバーは最初のツール呼び出し中にアカウント登録を自動的に行い、認証情報をローカルのJSONファイルに保存します。開発者は環境変数を通じて独自のAPIキーを提供することも可能です。システムには、バンドルのリスト表示、Bitcoinによるクォータの購入、支払いステータスの確認など、アカウントクレジットを管理するためのツールが含まれています。デフォルトではインボックスは30日後に期限切れになりますが、keep_inboxツールを使用することで、パスワードリセットなどの長期的なニーズに合わせてアドレスを永続化できます。
できること
- 1メールからの認証コードの抽出受信メッセージを解析して、特定のOTPコードやアクションリンクを取得できます。
- 2Bitcoinによるサービスクレジットの管理エージェントが支払いURLを生成し、取引が確定したかどうかを確認することで、クォータの購入を促進できます。
- 3永続的なメールアドレスの維持開発者はインボックスの期限切れを防ぎ、将来のパスワードリセットメールを受信できるように設定できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
EmptyInbox MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにEmptyInbox MCPをインストール
$ claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcpCursorにEmptyInbox MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}VS CodeにEmptyInbox MCPをインストール
.vscode/mcp.json
{
"servers": {
"emptyinbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}VS Code CLIにEmptyInbox MCPをインストール
$ code --add-mcp '{"name":"emptyinbox","type":"stdio","command":"npx","args":["-y","emptyinbox-mcp"],"env":{"EMPTYINBOX_API_KEY":"<YOUR_EMPTYINBOX_API_KEY>"}}'Claude DesktopにEmptyInbox MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}CodexにEmptyInbox MCPをインストール
$ codex mcp add emptyinbox --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' -- npx -y emptyinbox-mcpCodex config.tomlにEmptyInbox MCPをインストール
~/.codex/config.toml
[mcp_servers.emptyinbox] command = "npx" args = ["-y", "emptyinbox-mcp"] [mcp_servers.emptyinbox.env] EMPTYINBOX_API_KEY = "<YOUR_EMPTYINBOX_API_KEY>"
Gemini CLIにEmptyInbox MCPをインストール
$ gemini mcp add -s user -e 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox npx -- -y emptyinbox-mcpGemini settings.jsonにEmptyInbox MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}EmptyInbox MCPツール 11
READMEから検出create_inboxlist_inboxeslist_messagesget_messagewait_for_messageget_quotalist_bundlesbuy_quotacheck_paymentkeep_inboxreport_issue
| create_inbox | — | |
| list_inboxes | — | |
| list_messages | — | |
| get_message | — | |
| wait_for_message | — | |
| get_quota | — | |
| list_bundles | — | |
| buy_quota | — | |
| check_payment | — | |
| keep_inbox | — | |
| report_issue | — |
設定
EMPTYINBOX_API_KEYシークレットExisting EmptyInbox API key. Omit to auto-register a free account on the first tool call that needs one; the key is then written to ~/.emptyinbox.json.
| 名前 | 説明 | 種類 |
|---|---|---|
| EMPTYINBOX_API_KEY | Existing EmptyInbox API key. Omit to auto-register a free account on the first tool call that needs one; the key is then written to ~/.emptyinbox.json. | シークレット |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)No license検出事項
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るemptyinbox-mcp
MCP server for EmptyInbox — create disposable email inboxes and read messages from AI agents.
Listed in the official MCP Registry as io.github.cnohall/emptyinbox.
Setup
Claude Code:
claude mcp add emptyinbox -- npx -y emptyinbox-mcp@latest
Any other MCP client — add to its config:
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": ["-y", "emptyinbox-mcp@latest"]
}
}
}
No setup: the first tool call that needs an account registers one automatically and saves the key to ~/.emptyinbox.json for future sessions. Starting the server on its own (as MCP hosts do to list tools) creates nothing.
Bring your own account (optional — to reuse an existing key):
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": ["-y", "emptyinbox-mcp@latest"],
"env": {
"EMPTYINBOX_API_KEY": "your_api_key_here"
}
}
}
}
Get an API key at https://emptyinbox.me/settings.html
Tools
| Tool | Description |
|---|---|
create_inbox |
Create a new email address; it expires after 30 days unless kept |
list_inboxes |
List all inboxes on your account |
list_messages |
List received messages, each with its extracted code, action link and text preview |
get_message |
Get one message parsed (code, links, plain text), or format="text" for a flat rendering |
wait_for_message |
Block until an email arrives — perfect for signup/OTP flows; returns the extracted code with it |
get_quota |
Credits remaining on the account |
list_bundles |
List quota bundles and prices |
buy_quota |
Quote a Bitcoin payment; returns a pay_url for the user plus address, amount and BIP21 URI |
check_payment |
Check whether a payment landed and quota was credited |
keep_inbox |
Make an inbox permanent (30 credits) so it keeps receiving mail, e.g. password resets |
report_issue |
Send a bug, payment problem, docs gap or feature request to the team; never creates an account |
Example agent workflow
1. create_inbox → "clever.sunny.butterfly@emptyinbox.me"
2. [agent signs up to some service using that address]
3. wait_for_message(inbox="clever.sunny.butterfly@emptyinbox.me", timeout_seconds=60)
4. → returns the verification email with code/link
Payment
Every account starts with free inboxes. When they run out, create_inbox returns
the prices and the agent can close the purchase without leaving the session:
- the agent shows its user the bundles and the user picks one
buy_quotareturns apay_url— a page with a QR code, the exact amount and live status — plus the raw address, amount and BIP21 URI- the user pays from any Bitcoin wallet (or an agent with its own wallet pays the BIP21 URI)
check_paymentwithwait_secondsconfirms the credit, usually within seconds of broadcast
buy_quota takes either a bundle id from list_bundles or a custom whole-dollar
usd amount from $1 to $100, for an agent spending down whatever a wallet holds.
A custom amount is priced at the best bundle rate it qualifies for. The network
fee the payer adds on top is the same whatever the size of the payment, so it
eats a far larger share of a dollar-sized top-up.
Quota is granted as soon as the payment is seen on the network, so there is no waiting for confirmations. Humans can also buy at https://emptyinbox.me/inboxes.html
EmptyInbox MCPのよくある質問
EmptyInbox MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
EmptyInbox MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
EmptyInbox MCPが提供するツールは
11個のツールを提供しており、create_inbox, list_inboxes, list_messages, get_message, wait_for_messageなどがあります。
EmptyInboxのセットアップ方法は?
このMCP serverは手動でのセットアップは不要です。アカウントが必要な最初のツール呼び出し時に、自動的にアカウントが登録され、キーがローカルに保存されます。
エージェントは認証コードをどのように処理しますか?
wait_for_messageツールはメールが届くまで待機することができ、抽出したコードを返すため、サインアップやOTP(ワンタイムパスワード)フローに最適です。
追加のクォータの支払いはどのように行いますか?
エージェントはbuy_quotaを通じてBitcoinによる支払いを提示できます。これにより、ユーザーが取引を完了するための支払いURLとBIP21 URIが提供されます。