MinuteMail MCP server
online · 100% uptimeio.github.minutemailco/mcp-server·v1.1.3Ephemeral mailboxes and a mock OAuth IdP for testing email and auth flows — 39 API-driven tools
0 stars
Reviews
Write oneNobody has reviewed MinuteMail yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
MinuteMail tools (40, 17 write)
write = sends, deletes, buys or postsarchived.deletewrite actionFreePermanently delete an archived mailbox.
archived.getFreeFetch a single archived mailbox by ID.
archived.listFreeList the tenant's archived (expired but recoverable) mailboxes.
archived.reactivateFreeReactivate an archived mailbox back to active state.
attachments.addFreeAttach a file to a test-injected email (base64 payload).
attachments.deletewrite actionFreeDelete a single attachment.
attachments.delete_bulkwrite actionFreeDelete several attachments of one email at once.
attachments.getFreeDownload an attachment. The file contents are returned base64-encoded in the JSON "data" field.
attachments.listFreeList the attachments of an email (metadata only).
domains.deletewrite actionFreeDelete a registered custom domain.
domains.listFreeList the tenant's custom domains with their DNS verification status.
domains.registerFreeRegister a new custom domain. DNS records (TXT token + MX) must then be added before verification can succeed.
domains.verifyFreeTrigger DNS verification (TXT + MX) of a registered domain.
identities.createwrite actionFreeCreate a mock identity bound to a mailbox for OAuth flow testing.
identities.deletewrite actionFreeDelete a mock identity.
identities.getFreeFetch a single mock identity by ID.
identities.listFreeList the tenant's mock identities, optionally filtered by OAuth client or mailbox address.
identities.updatewrite actionFreeUpdate a mock identity: profile fields, isActive (activate/deactivate), emailVerified, and custom claims merged into the ID token and userinfo.
mailboxes.createwrite actionFreeCreate a new temporary mailbox. The domain defaults to the tenant's default domain; the owner is always the API key's owner.
mailboxes.deletewrite actionFreeDelete a mailbox and its contents by ID.
mailboxes.delete_bulkwrite actionFreeDelete several mailboxes at once by ID.
mailboxes.getFreeFetch a single mailbox by ID.
mailboxes.listFreeList the tenant's active mailboxes (owner is derived from the API key). Optionally look up a single mailbox by exact address.
mails.deletewrite actionFreeDelete a single email.
mails.delete_bulkwrite actionFreeDelete several emails of one mailbox at once.
mails.getFreeFetch a single email by ID, including body and attachment metadata.
mails.injectFreeInject a simulated inbound email into a mailbox (multipart upload). No external mail is sent; use this to simulate inbound mail for flow testing.
mails.listFreeList the emails in a mailbox, newest first.
oauth.clients.createwrite actionFreeRegister an OAuth client for mock identity flows. The plaintext clientSecret is returned once at creation.
oauth.clients.deletewrite actionFreeDelete an OAuth client by its public client ID.
oauth.clients.getFreeFetch a single OAuth client by its public client ID.
oauth.clients.listFreeList the tenant's OAuth clients for mock identity testing.
oauth.clients.rotate_secretFreeRotate an OAuth client's secret. The new plaintext secret is returned once.
team.invitations.createwrite actionFreeCreate a team invitation for an email address (SMTP invite is sent by the team service).
team.invitations.deletewrite actionFreeRevoke a team invitation.
team.invitations.listFreeList the tenant's team invitations.
team.members.addFreeAdd a team member directly (no invitation flow).
team.members.deletewrite actionFreeRemove a team member.
team.members.getFreeFetch a single team member by ID.
team.members.listFreeList the tenant's team members.
Public scan report
scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 716ms20/20
- Tool poisoning40 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 15 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How MinuteMail compares
Against every graded Email MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 78% of 916 Email servers
- Tools
- 40
- the typical Email server has 7
- Tools that change things
- 43%
- typical: 25%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Email server answers 100%
- Response time
- 417 ms
- faster than 37% of 609 Email servers
What its tools let an agent do: 21 read · 4 create · 6 change · 9 delete
Install MinuteMail in Claude Code, Cursor or VS Code
claude mcp add --transport http mcp-server https://mcp.minutemail.co/mcp
What the publisher says
From the MinuteMail repository's README, as published. We do not edit it. Read it on GitHub
MinuteMail MCP Server
MinuteMail as MCP (Model Context Protocol) tools: let AI agents and MCP clients operate ephemeral mailboxes, emails, attachments, custom domains, teams, and mock OAuth identities for testing email and auth flows.
revision 2025-06-18)
- Endpoint: https://mcp.minutemail.co/mcp (Streamable HTTP, protocol
stateless proxy — it holds no credentials, sessions, or local storage of its own; your key is forwarded verbatim to the MinuteMail API, where scopes and quotas are enforced. All state (mailboxes, mails, identities) lives in the MinuteMail platform behind it.
- Auth: your MinuteMail API key (Bearer mmak_...). The server is a
as io.github.minutemailco/mcp-server and on Smithery.
- Also listed in the official MCP Registry
Get an API key
- Sign up at minutemail.co (free during early access)
- Create an API key in the dashboard
- Configure your MCP client to send it as the Authorization header:
Authorization: Bearer mmak_XXXXXXXX
Connect your MCP client
Claude Code / Claude Desktop / Cursor / any Streamable HTTP client:
- URL: https://mcp.minutemail.co/mcp
- Header: Authorization: Bearer mmak_...
Claude Code CLI:
claude mcp add --transport http minutemail https://mcp.minutemail.co/mcp \
--header "Authorization: Bearer mmak_XXXXXXXX"Claude Desktop / clients with an mcpServers JSON config (e.g. claudedesktopconfig.json / ~/.cursor/mcp.json):
{
"mcpServers": {
"minutemail": {
"type": "http",
"url": "https://mcp.minutemail.co/mcp",
"headers": {
"Authorization": "Bearer mmak_XXXXXXXX"
}
}
}
}Some clients (older Claude Desktop builds) only support local stdio
servers in their JSON config. If yours rejects type: "http", use the
built-in remote/connectors UI with the URL and header above, or run
mcp-remote as a stdio bridge:
json
{
"mcpServers": {
"minutemail": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.minutemail.co/mcp",
"--header",
"Authorization: Bearer mmak_XXXXXXXX"
]
}
}
}
For a guided walkthrough, see the docs: docs.minutemail.co/mcp/getting-started.
Raw JSON-RPC (what the clients do under the hood):
curl -s https://mcp.minutemail.co/mcp \
-H 'Authorization: Bearer mmak_XXXXXXXX' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"mailboxes.create","arguments":{"expiresIn":30}}}'Tools (39)
Every tool maps 1:1 to a route of the MinuteMail API. All calls require the Bearer API key; write operations require the matching scope (mailboxes, domains, team, identities).
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
MinuteMail: common questions
- Is MinuteMail MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the MinuteMail safety report
- How do I install MinuteMail?
- It runs remotely at mcp.minutemail.co. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does MinuteMail need an API key?
- Yes. The registry entry asks for
Authorization. - Is MinuteMail maintained?
- The last commit was 20 days ago (2026-10-17). The latest release is v1.1.3.
- Is MinuteMail up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of MinuteMail?
- Servers from other publishers that do the same job: Atomic Mail MCP server, smbCloud Mail & Auth MCP server and Openagentemail MCP server.
- How does MinuteMail compare with other Email MCP servers?
- safety score 85/100 (higher than 78% of 916 Email servers); tools 40 (the typical Email server has 7); tools that change things 43% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to MinuteMail
Same job from other publishers: the closest match first, then the best rated.
- Atomic MailProgrammable email inbox for AI agents — JMAP, PoW auth, stdio MCP server.not reviewedEstablishedA
smbCloud Mail & AuthEmail infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.not reviewedEstablishedA- OpenagentemailUnlimited agent mailboxes — create identities, read/wait for mail, extract OTPs, send email.not reviewedGrowingB
- flightclawSearch ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.not reviewedGrowingA
- FluxmailRead, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.not reviewedGrowingB