agent-inbox

Overview

agent-inbox is a well-implemented MCP server that creates temporary email addresses on demand, allowing AI agents to sign up for services, receive confirmation emails, and extract verification links without manual intervention. The server supports multiple email providers with automatic fallback, includes tools for inbox management and verification link extraction, and offers an interactive installer that auto-configures with popular AI coding agents. The implementation includes proper cleanup mechanisms and smart polling with backoff for reliable email detection.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• create_inbox

  Spin up a temporary email address with optional prefix and name for reference.

  Try:Create a new inbox with prefix 'signup' and name 'test'Try:Generate a temporary email for sign-up verification
• check_inbox

  Check for messages in an inbox, returning subjects, bodies, and verification links.

  Try:Check my inbox for new messagesTry:Show me all emails with verification links
• wait_for_email

  Poll until a matching email arrives, filtering by sender and subject with auto-retries.

  Try:Wait for an email from 'noreply@example.com' with subject containing 'confirm'Try:Poll for a welcome email with timeout
• verify_email

  One-shot verification: polls for confirmation email, extracts the link, and visits it.

  Try:Verify my email by clicking the confirmation linkTry:Automatically confirm my account registration
• list_inboxes

  Show all active inboxes with their names and providers.

  Try:List all my active email inboxesTry:Show me all temporary email addresses currently in use
• delete_inbox

  Destroy an inbox and its backing account.

  Try:Delete the inbox named 'test'Try:Clean up and remove all my temporary emails

Comparable tools

Installation

npx gsd-agent-inbox

{
  "mcpServers": {
    "agent-inbox": {
      "command": "npx",
      "args": ["-y", "gsd-agent-inbox"]
    }
  }
}

FAQ

Does it require API keys or accounts?

No API keys or accounts are required. The server uses mail.tm as the primary provider with automatic fallback to 1secmail.

How long do email inboxes last?

Inboxes are in-memory only and don't survive server restarts. They are automatically cleaned up when the MCP server shuts down.

Can it handle attachment downloads?

No, it currently only supports text and HTML email bodies without attachment support.

Compare agent-inbox with