emptyinbox-mcp

MCP server for EmptyInbox — create disposable email inboxes and read messages from AI agents.

Setup

Zero config — just add to your MCP config and it works:

{
  "mcpServers": {
    "emptyinbox": {
      "command": "npx",
      "args": ["-y", "emptyinbox-mcp"]
    }
  }
}

On first use, the agent calls register_account to create a free account automatically. The API key is saved to ~/.emptyinbox.json for future sessions.

Bring your own account (optional — for more than 1 inbox quota):

{
  "mcpServers": {
    "emptyinbox": {
      "command": "npx",
      "args": ["-y", "emptyinbox-mcp"],
      "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 disposable email address | | list_inboxes | List all inboxes on your account | | list_messages | List received messages (optionally filter by inbox) | | get_message | Get full content of a message by ID | | wait_for_message | Block until an email arrives — perfect for signup/OTP flows |

Example agent workflow

1. create_inbox → "[email protected]"
2. [agent signs up to some service using that address]
3. wait_for_message(inbox="[email protected]", timeout_seconds=60)
4. → returns the verification email with code/link

Payment

Free accounts include 5 inboxes. Buy more quota with BTC or USDT at https://emptyinbox.me/inboxes.html