Question 1

What is MinuteMail?

Accepted Answer

MinuteMail is a testing framework for developers and QA engineers. It provides ephemeral mailboxes, a mock OAuth identity provider, a REST API with Python SDK, and an MCP Server — everything you need to test user flows end-to-end without touching production infrastructure.

Question 2

How do ephemeral mailboxes work?

Accepted Answer

Each mailbox has a configurable lifetime between 1 and 60 minutes. Create them via the web UI, REST API, or MCP Server. Messages arrive in real-time via SSE. When a mailbox expires, all messages and attachments are automatically and permanently deleted.

Question 3

What is the mock OAuth identity provider?

Accepted Answer

MinuteMail includes a full OAuth 2.0 mock identity provider. Register OAuth clients, create mock identities linked to mailboxes, and test real authorization code flows, token exchanges, and userinfo endpoints — all without real user accounts or production auth systems.

Question 4

How do I integrate MinuteMail into my test suite?

Accepted Answer

Use the REST API with API key authentication, or the official Python SDK. Generate API keys from your dashboard, create mailboxes programmatically, poll for messages, and assert on email content — all fully automatable in CI/CD pipelines.

Question 5

What is the MCP Server?

Accepted Answer

The MCP (Model Context Protocol) Server lets AI assistants like Claude create test mailboxes, check for received emails, and orchestrate multi-step user flows through natural language. Connect it to your AI tool and drive email testing conversationally.

Question 6

Can I reuse the same email address across test runs?

Accepted Answer

Yes. Archive a mailbox to reserve its email address. When you reactivate it, you get the same address with a fresh empty inbox — perfect for maintaining stable test fixtures while keeping message history clean.

Question 7

Does MinuteMail support custom domains?

Accepted Answer

Yes. Configure your own domain for test mailboxes by adding MX and TXT verification records to your DNS. Custom domains are available on Pro and Team plans and are useful for testing email flows that filter by sender domain.

Question 8

What are the plan limits for mailboxes and API calls?

Accepted Answer

Free includes 50 API calls/day, 2 active mailboxes, 3 archived mailboxes, 2 mock identities, and 1 API key. Hobbyist raises that to 1,000 calls, 10 active mailboxes, 20 archived, 10 identities, 5 keys. Pro offers 10,000 calls, 50 active, 200 archived, 25 identities, 10 keys, and 5 custom domains. Team adds 50,000 shared calls, 200 active mailboxes, 100 identities, unlimited keys, 20 domains, and up to 5 team members.

Question 9

How are API keys managed?

Accepted Answer

Generate API keys from your dashboard with customizable scopes, optional domain restrictions, and expiration dates. Keys are validated with bcrypt and enforce per-tenant usage quotas. Use them to authenticate all REST API and SDK requests.

The testing framework for email and auth flows

Try it now

Everything you need to test user flows

Ephemeral Mailboxes

Mock OAuth IdP

REST API & SDK

MCP Server

Frequently Asked Questions