Allows AI agents to create disposable email inboxes, read messages, and automatically extract verification codes for signup flows.
Also known as blockonomics/emptyinbox-me, emptyinbox-mcp
- Stars
- 4
- Tools
- 11
- Downloads, 30 days
- —
- Latest version
- 1.5.0
- Last commit
- Nov 13, 2026
- License
- —
What is EmptyInbox MCP?
EmptyInbox allows AI agents to create disposable email inboxes, read messages, and automatically extract verification codes for signup flows. It exposes 11 tools, such as create_inbox, list_inboxes, list_messages.
Summary generated from the project's README
About EmptyInbox MCP server
EmptyInbox provides a way for AI agents to manage disposable email addresses for automated tasks. This MCP server allows agents to generate new inboxes, read incoming messages, and extract specific data like verification codes or action links. It is designed to handle signup flows and one-time password requirements without manual human intervention.
Users can set this up via Claude Code or by adding the npx command to any standard MCP client configuration. The server handles account registration automatically during the first tool call, saving the credentials to a local JSON file. Developers can also provide their own API key through environment variables. The system includes tools for managing account credits, such as listing bundles, buying quota via Bitcoin, and checking payment status. While inboxes expire after 30 days by default, the keep_inbox tool allows users to make an address permanent for long-term needs like password resets.
What you can do with it
- 1Extract verification codes from emailsThe server can parse incoming messages to retrieve specific OTP codes or action links.
- 2Manage service credits with BitcoinAn agent can facilitate quota purchases by generating a payment URL and checking when the transaction is confirmed.
- 3Maintain permanent email addressesA developer can ensure an inbox does not expire so it can receive future password reset emails.
Written from the project's README. Every use case is checked against a quote from it.
How to install EmptyInbox MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall EmptyInbox MCP in Claude Code
$ claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcpInstall EmptyInbox MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}Install EmptyInbox MCP in VS Code
.vscode/mcp.json
{
"servers": {
"emptyinbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}Install EmptyInbox MCP in VS Code CLI
$ code --add-mcp '{"name":"emptyinbox","type":"stdio","command":"npx","args":["-y","emptyinbox-mcp"],"env":{"EMPTYINBOX_API_KEY":"<YOUR_EMPTYINBOX_API_KEY>"}}'Install EmptyInbox MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}Install EmptyInbox MCP in Codex
$ codex mcp add emptyinbox --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' -- npx -y emptyinbox-mcpInstall EmptyInbox MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.emptyinbox] command = "npx" args = ["-y", "emptyinbox-mcp"] [mcp_servers.emptyinbox.env] EMPTYINBOX_API_KEY = "<YOUR_EMPTYINBOX_API_KEY>"
Install EmptyInbox MCP in Gemini CLI
$ gemini mcp add -s user -e 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox npx -- -y emptyinbox-mcpInstall EmptyInbox MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}EmptyInbox MCP tools 11
Detected from the READMEcreate_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 | — |
Configuration
EMPTYINBOX_API_KEYSecretExisting 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.
| Name | Description | |
|---|---|---|
| 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. | Secret |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablePass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubemptyinbox-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 questions
How do I add EmptyInbox MCP to Claude Code?
Run claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcp in your terminal. Add --scope user to make it available in every project.
How do I add EmptyInbox MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does EmptyInbox MCP provide?
It exposes 11 tools, including create_inbox, list_inboxes, list_messages, get_message, wait_for_message.
How do I set up EmptyInbox?
The server requires no manual setup; the first tool call that needs an account will automatically register one and save the key locally.
How does the agent handle verification codes?
The wait_for_message tool can block until an email arrives, making it ideal for signup or OTP flows by returning the extracted code.
How are payments handled for more quota?
Agents can quote a Bitcoin payment via buy_quota, which provides a payment URL and BIP21 URI for the user to complete the transaction.