Agent Inbox
https://github.com/gsd-build/agent-inbox- Category
- AI Agents
- Rank
- No. 1559Tools index
Previous survey · No. 1529 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- gsd-build
- GitHub
- 61 stars
- Date
About
Give any AI agent a disposable email inbox in one tool call. MCP server for email verification, auth flows, and testing.
What it does
Agent Inbox lets an AI coding agent create a temporary address, receive messages, find confirmation links, visit a verification URL, and remove the inbox. It keeps active inboxes in memory, supports readable names, and switches email providers when its primary service fails.
Why it's ranked here
The appeal is a focused workflow with little setup friction. Automatic polling, sender and subject filters, link extraction, HTTP verification, provider fallback, and cleanup cover the repetitive parts of sign-up testing. Its usefulness still depends on target services accepting disposable domains.
What's good
The tool combines inbox creation, message retrieval, filtering, confirmation-link detection, link visiting, and cleanup behind six clear operations. Named inboxes reduce address handling across steps. Polling uses backoff, verification follows redirects, and the installer supports several popular AI coding clients plus generic standard-input MCP clients.
Tradeoffs
Inbox state exists only in server memory, so restarts lose active references. Some services reject disposable domains. Attachments are unsupported. Confirmation links are selected through URL keyword matching, and automatic verification visits the first detected match with an HTTP GET. Cleanup for the fallback provider relies on automatic expiry because that service offers no deletion API.
How to use it well
Use it for automated sign-up, account confirmation, magic-link, and end-to-end email tests driven by an MCP-capable agent. Prefer filtered polling when several messages may arrive, then delete the inbox after the flow. It does not replace a persistent mailbox, attachment testing, or browser automation when verification requires an interactive page.
Technical notes+
package.json defines an ESM npm package, a command-line binary, Node.js 18 or newer, TypeScript compilation, and dependencies on the MCP SDK and Zod. src/index.ts selects the interactive installer when standard input is a terminal and otherwise starts a stdio MCP server; it stores inboxes and name aliases in Maps, registers six tools, and performs best-effort cleanup on termination signals. src/mail-tm.ts implements mail.tm account creation and authenticated message access, catches primary-provider creation failures to use 1secmail, fetches full messages sequentially, and extracts URLs from text and HTML with a keyword filter. bin/install.cjs detects supported agent configuration directories, writes JSON or TOML MCP entries, and can download skill/SKILL.md. tsconfig.json enables strict TypeScript, NodeNext modules, declarations, source maps, isolated modules, and unchecked-index safeguards.
Observed
- License
- MIT
- Primary language
- TypeScript
- Packaging
- ESM npm package installed and launched with npx
- Runtime
- Node.js 18 or newer
- Interface
- MCP server over stdio with six inbox operations
- Supported client setup
- Claude Code, Codex CLI, Cursor, Gemini CLI, Windsurf, and other stdio MCP clients
- Email providers
- mail.tm primary with automatic 1secmail fallback
Read from README.md, package.json, src/index.ts, src/mail-tm.ts, LICENSE, install.sh, tsconfig.json, skill/SKILL.md, bin/install.cjs.
What it can do
Create disposable email inbox for AI agent
AI agent request → Temporary email address and inbox
Verify email addresses
Email address → Email verification status
Handle authentication flows via email
Authentication request and email credentials → Authentication tokens or confirmation
Receive and store incoming emails
Incoming email messages → Stored email content and metadata
Provide email testing environment
Test email scenarios → Email delivery and response data
Execute email operations via MCP server calls
MCP tool call requests → Email operation results
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.