Give any AI agent a disposable email inbox in one tool call. MCP server for email verification, auth flows, and testing.
{
"mcpServers": {
"agent-inbox": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Give any AI agent a disposable email inbox in one tool call. MCP server for email verification, auth flows, and testing.
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
MIT. View license →
Is it maintained?
Last commit 2 days ago. 18 stars.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
No automated test available for this server. Check the GitHub README for setup instructions.
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite
This MCP server allows Claude and other AI assistants to access your LinkedIn. Scrape LinkedIn profiles, companies and jobs, and manage your inbox.
B2B lead generation MCP server - 20+ scrapers, email finder, skip trace, and more.
Real-time DNS security analysis — DNSSEC, email auth, and RDAP. Built for SOC investigations.
MCP Security Weekly
Get CVE alerts and security updates for Agent Inbox and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Give any AI agent a disposable email inbox in one tool call.
npx gsd-agent-inbox
The interactive installer auto-detects your AI coding agents (Claude Code, Codex CLI, Cursor, Gemini CLI, Windsurf), configures the MCP server, and installs the optional skill for each.
When launched by an MCP client (non-TTY), it starts the MCP server normally. When you run it from a terminal, you get the installer.
An MCP server that creates real, temporary email addresses on demand. Your agent can sign up for services, receive confirmation emails, extract verification links, and clean up — without you lifting a finger.
No API keys. No accounts. No configuration. Works with any email-sending service — Supabase, Resend, SendGrid, Postmark, AWS SES, whatever.
AI agents hit a wall when a service requires email verification. They can fill out a sign-up form, but they can't receive the confirmation email. So they stop and ask you to do it.
Agent: create_inbox({ prefix: "signup", name: "test" })
→ signup-1712345678@somedomain.com (name: test)
Agent: [fills sign-up form with that email]
Agent: verify_email({ address: "test", subject_contains: "confirm" })
→ Email verified successfully!
Verification URL: https://myapp.supabase.co/auth/v1/verify?token=abc123
HTTP Status: 200
Agent: delete_inbox({ address: "test" })
→ Done.
If you prefer to configure manually instead of using the installer:
claude mcp add agent-inbox -- npx -y gsd-agent-inbox
Or add to ~/.claude/settings.json:
{
"mcpServers": {
"agent-inbox": {
"command": "npx",
"args": ["-y", "gsd-agent-inbox"]
}
}
}
Add to ~/.codex/config.toml:
[mcp_servers.agent-inbox]
command = "npx"
args = ["-y", "gsd-agent-inbox"]
env = { }
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"agent-inbox": {
"command": "npx",
"args": ["-y", "gsd-agent-inbox"]
}
}
}
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"agent-inbox": {
"command": "npx",
"args": ["-y", "gsd-agent-inbox"]
}
}
}
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"agent-inbox": {
"command": "npx",
"args": ["-y", "gsd-agent-inbox"]
}
}
}
Any client that supports stdio transport:
{
"command": "npx",
"args": ["-y", "gsd-agent-inbox"]
}
git clone https://github.com/gsd-build/agent-inbox.git
cd agent-inbox
npm install
npm run build
npm start
| Tool | What it does |
|---|---|
create_inbox | Spin up a temporary email address. Optional prefix for readability, optional name for easy reference. |
check_inbox | Check for messages. Returns subjects, bodies, and auto-extracted verification links. |
wait_for_email | Poll until a matching email arrives. Filters by sender and subject. Auto-retries with backoff. |
verify_email | One-shot verification: polls for confirmation email, extracts the link, visits it via HTTP. Three steps in one tool call. |
list_inboxes | Show all active inboxes with names and providers. |
delete_inbox | Destroy an inbox and its backing account. |
Give inboxes a name for easy reference across multiple tool calls:
create_inbox({ prefix: "signup", name: "main" })
wait_for_email({ address: "main", subject_contains: "confirm" })
delete_inbox({ address: "main" })
The installer can optionally add a skill file that teaches your AI agent when and how to use agent-inbox — so it reaches for the inbox tools automatically when it encounters auth flows, email verification, or sign-up testing.
To install the skill manually:
mkdir -p ~/.claude/sk
... [View full README on GitHub](https://github.com/gsd-build/agent-inbox#readme)