Ermöglicht es AI Agents, disposable Email-Postfächer zu erstellen, Nachrichten zu lesen und Verifizierungscodes für Signup-Flows automatisch zu extrahieren.
Auch bekannt als blockonomics/emptyinbox-me, emptyinbox-mcp
- Stars
- 4
- Tools
- 11
- Downloads, 30 Tage
- —
- Neueste Version
- 1.5.0
- Letzter Commit
- 13. Nov. 2026
- Lizenz
- —
Was ist EmptyInbox MCP?
Ermöglicht es AI Agents, disposable Email-Postfächer zu erstellen, Nachrichten zu lesen und Verifizierungscodes für Signup-Flows automatisch zu extrahieren. Er stellt 11 Tools bereit, etwa create_inbox, list_inboxes, list_messages.
Zusammenfassung generiert aus dem README des Projekts
Über EmptyInbox MCP server
EmptyInbox bietet AI Agents eine Möglichkeit, disposable E-Mail-Adressen für automatisierte Aufgaben zu verwalten. Dieser MCP server ermöglicht es Agents, neue Inboxes zu generieren, eingehende Nachrichten zu lesen und spezifische Daten wie Verifizierungscodes oder Action-Links zu extrahieren. Er ist darauf ausgelegt, Signup-Flows und One-Time-Password-Anforderungen ohne manuelles Eingreifen eines Menschen zu bewältigen.
User können dies über Claude Code oder durch Hinzufügen des npx-Befehls zu einer Standard-MCP-Client-Config einrichten. Der Server übernimmt die Account-Registrierung automatisch beim ersten Tool-Call und speichert die Credentials in einer lokalen JSON-Datei. Developer können auch ihren eigenen API-Key über Umgebungsvariablen bereitstellen. Das System enthält Tools zur Verwaltung von Account-Credits, wie das Auflisten von Bundles, den Kauf von Quota via Bitcoin und das Überprüfen des Zahlungsstatus. Während Inboxes standardmäßig nach 30 Tagen ablaufen, ermöglicht das Tool keep_inbox es Usern, eine Adresse für langfristige Bedürfnisse wie Passwort-Resets permanent zu machen.
Was du damit machen kannst
- 1Verifizierungscodes aus E-Mails extrahierenDer Server kann eingehende Nachrichten parsen, um spezifische OTP-Codes oder Action-Links abzurufen.
- 2Service-Credits mit Bitcoin verwaltenEin Agent kann den Kauf von Quota erleichtern, indem er eine Payment-URL generiert und prüft, wann die Transaktion bestätigt wurde.
- 3Permanente E-Mail-Adressen beibehaltenEin Developer kann sicherstellen, dass eine Inbox nicht abläuft, damit sie zukünftige Passwort-Reset-E-Mails empfangen kann.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du EmptyInbox MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenEmptyInbox MCP in Claude Code installieren
$ claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcpEmptyInbox MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}EmptyInbox MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"emptyinbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}EmptyInbox MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"emptyinbox","type":"stdio","command":"npx","args":["-y","emptyinbox-mcp"],"env":{"EMPTYINBOX_API_KEY":"<YOUR_EMPTYINBOX_API_KEY>"}}'EmptyInbox MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}EmptyInbox MCP in Codex installieren
$ codex mcp add emptyinbox --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' -- npx -y emptyinbox-mcpEmptyInbox MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.emptyinbox] command = "npx" args = ["-y", "emptyinbox-mcp"] [mcp_servers.emptyinbox.env] EMPTYINBOX_API_KEY = "<YOUR_EMPTYINBOX_API_KEY>"
EmptyInbox MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox npx -- -y emptyinbox-mcpEmptyInbox MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"emptyinbox": {
"command": "npx",
"args": [
"-y",
"emptyinbox-mcp"
],
"env": {
"EMPTYINBOX_API_KEY": "<YOUR_EMPTYINBOX_API_KEY>"
}
}
}
}EmptyInbox MCP tools 11
Erkannt aus dem 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 | — |
Konfiguration
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 | Beschreibung | Typ |
|---|---|---|
| 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 |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)No licenseBefund
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenemptyinbox-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 Fragen
Wie füge ich EmptyInbox MCP zu Claude Code hinzu?
Führe claude mcp add --env 'EMPTYINBOX_API_KEY=<YOUR_EMPTYINBOX_API_KEY>' emptyinbox -- npx -y emptyinbox-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich EmptyInbox MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet EmptyInbox MCP?
Er stellt 11 Tools bereit, darunter create_inbox, list_inboxes, list_messages, get_message, wait_for_message.
Wie richte ich EmptyInbox ein?
Der Server erfordert keine manuelle Einrichtung; der erste Tool-Call, der ein Konto benötigt, registriert automatisch eines und speichert den Key lokal.
Wie geht der Agent mit Verifizierungscodes um?
Das Tool wait_for_message kann blockieren, bis eine E-Mail eintrifft, was es ideal für Signup- oder OTP-Flows macht, da der extrahierte Code zurückgegeben wird.
Wie werden Zahlungen für mehr Quota abgewickelt?
Agents können eine Bitcoin-Zahlung via buy_quota anfordern, die eine Payment-URL und eine BIP21 URI bereitstellt, damit der User die Transaktion abschließen kann.