Disposable Email Inbox

v1.0.0Communicationstable

Give any AI agent a disposable email inbox in one tool call. MCP server for email verification, auth flows, and testing.

ai-agentauthclaudecursordisposable-email
Share:
43
Stars
0
Downloads
0
Weekly
0/5

What is Disposable Email Inbox?

Disposable Email Inbox is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to give any ai agent a disposable email inbox in one tool call. mcp server for email verification, auth flows, and testing.

Give any AI agent a disposable email inbox in one tool call. MCP server for email verification, auth flows, and testing.

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Give any AI agent a disposable email inbox in one tool call.

Use Cases

Email verification workflows
Authentication testing
Agent email handling
gsd-build

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx agent-inbox

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Disposable Email Inbox

Agent Inbox gives any AI agent a fully functional disposable email inbox in a single tool call, enabling automated email verification flows, authentication testing, and any workflow that requires a real email address without creating permanent accounts. The MCP server exposes tools to create inboxes, check for messages, wait for specific emails, extract verification links, and automatically visit them — covering the complete email confirmation loop that many SaaS sign-up flows require. It requires no API keys or accounts, making it zero-friction to add to Claude, Cursor, or any other MCP-compatible agent.

Prerequisites

  • Node.js 16 or higher and npm installed
  • npx available in your PATH (comes with npm)
  • An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
1

Run the interactive installer

The quickest way to set up agent-inbox is to run the npx installer, which auto-detects your AI agent and configures it automatically.

npx gsd-agent-inbox
2

Or configure Claude Desktop manually

If you prefer manual setup, add the server directly to your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).

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

Or configure Claude Code

For Claude Code, add the server to ~/.claude/settings.json under the mcpServers key.

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

Restart your MCP client

Fully quit and reopen Claude Desktop or reload Claude Code. The agent-inbox tools should appear in the available tools list.

Disposable Email Inbox Examples

Client configuration

Complete claude_desktop_config.json block for the Agent Inbox MCP server — no API keys or environment variables required.

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

Prompts to try

Example prompts for using Agent Inbox to handle email verification workflows.

- "Create a disposable email inbox with prefix 'test-signup' and sign me up for the free trial at example.com."
- "Check my inbox for any new emails and show me their subjects."
- "Wait for an email from [email protected] with subject containing 'Verify' and extract the verification link."
- "Automatically verify the email I just received from the sign-up flow."
- "List all active inboxes and delete the ones I no longer need."

Troubleshooting Disposable Email Inbox

npx gsd-agent-inbox fails with package not found

Ensure you are using the exact package name 'gsd-agent-inbox' (not 'agent-inbox'). Run 'npm install -g gsd-agent-inbox' to install it globally if npx cannot resolve it.

wait_for_email times out and no email arrives

Disposable inboxes are created on external services and email delivery can take 30-60 seconds. Increase the polling timeout if the tool supports it. Also check that the service sending the email has not blocked disposable domains.

verify_email tool visits the link but the service still shows unverified

Some services require cookies or a browser session to complete verification via link click. The HTTP visit made by verify_email is a plain GET request. For such services, ask Claude to show you the link and complete verification manually in a browser.

Frequently Asked Questions about Disposable Email Inbox

What is Disposable Email Inbox?

Disposable Email Inbox is a Model Context Protocol (MCP) server that give any ai agent a disposable email inbox in one tool call. mcp server for email verification, auth flows, and testing. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Disposable Email Inbox?

Follow the installation instructions on the Disposable Email Inbox GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Disposable Email Inbox?

Disposable Email Inbox works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Disposable Email Inbox free to use?

Yes, Disposable Email Inbox is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Disposable Email Inbox?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides