# MoeMail

> MoeMail is a cute, fast, open-source temporary (disposable) email service built on Next.js and the Cloudflare stack. It generates throwaway email addresses that receive mail in real time, protecting your real inbox from spam and tracking. It offers a full OpenAPI (REST API) with API keys and webhooks for developers and automation testing, and its interface is available in seven languages.

## Key facts

- Create random or custom temporary email addresses instantly; mail arrives in real time.
- Mailboxes auto-expire; messages are deleted after expiration to protect privacy.
- Registration is required to securely manage your mailboxes.
- Email and mailbox sharing via share links.
- Full OpenAPI / RESTful API with API-key auth and webhook notifications.
- Open source and self-hostable for free on Cloudflare.

## Core pages

- [Home](https://moemail.app/en): What MoeMail is and how it works.
- [About](https://moemail.app/en/about): Background on the service and SoftMoe Studio.
- [Blog](https://moemail.app/en/blog): Guides and articles about temporary email and privacy.
- [10 Minute Mail](https://moemail.app/zh-TW/10-minute-mail): Short-lived inbox landing page, available only in Traditional Chinese, Japanese (`/ja/10-minute-mail`) and German (`/de/10-minute-mail`).
- [Disposable Email Checker](https://moemail.app/en/tools/disposable-email-checker): Free tool — look up whether a domain belongs to a disposable email provider, with two confidence levels and ready verdicts for 20 common domains.
- [Privacy Policy](https://moemail.app/en/privacy): How data is handled.
- [Terms of Service](https://moemail.app/en/terms): Usage terms.

## Email testing for developers

A reference section on testing email flows end to end with real, receivable inboxes. Start at the hub, which groups every page below.

- [Email Testing for Developers: The Complete Guide](https://moemail.app/en/email-testing): The hub.
- [Playwright Email Testing](https://moemail.app/en/email-testing/playwright): End-to-end tutorial.
- [Cypress Email Testing](https://moemail.app/en/email-testing/cypress): Verify emails in E2E tests.
- [Selenium Email Testing](https://moemail.app/en/email-testing/selenium)
- [Automate Email-Verification Testing](https://moemail.app/en/email-testing/verification): Across Playwright, Cypress and Selenium.
- [Testing Password-Reset Email Flows](https://moemail.app/en/email-testing/password-reset)
- [Automate OTP & 2FA Login Testing](https://moemail.app/en/email-testing/otp-2fa)
- [Testing Magic-Link / Passwordless Login](https://moemail.app/en/email-testing/magic-link)
- [Receive Email Programmatically in Node.js](https://moemail.app/en/email-testing/nodejs)
- [Receive Email with Python](https://moemail.app/en/email-testing/python)
- [Disposable Email API: A Developer's Guide](https://moemail.app/en/email-testing/api)
- [Receiving Inbound Email via Webhooks](https://moemail.app/en/email-testing/webhooks)
- [Email Testing in CI/CD (GitHub Actions)](https://moemail.app/en/email-testing/github-actions)
- [Mailosaur Alternatives](https://moemail.app/en/email-testing/mailosaur-alternative): Services that receive real email.
- [MailSlurp Alternatives](https://moemail.app/en/email-testing/mailslurp-alternative): When per-inbox pricing stops adding up.

## Languages

Every page is served under a locale prefix; replace `/en` with any of these. Blog posts and the email-testing section are fully translated in the first five (hreflang-linked); German and Portuguese translate the interface only, so read long-form content in one of the first five.

- English: https://moemail.app/en
- 简体中文 (Simplified Chinese): https://moemail.app/zh-CN
- 繁體中文 (Traditional Chinese): https://moemail.app/zh-TW
- 日本語 (Japanese): https://moemail.app/ja
- 한국어 (Korean): https://moemail.app/ko
- Deutsch (German): https://moemail.app/de
- Português (Brazil): https://moemail.app/pt-BR

## Developers

- [API documentation](https://docs.moemail.app/api.html#openapi): OpenAPI definition; authenticate with an API key from your profile.
- [MCP server, CLI and agent skill](https://moemail.app/en/mcp): `@moemail/mcp` gives Claude Desktop, Cursor, Claude Code and Codex eight tools (create a mailbox, wait for a verification email, read it, delete it); `@moemail/cli` is the same API as a `--json` command line with an installable SKILL.md.
- [Source code (GitHub)](https://github.com/beilunyang/moemail): Self-host on Cloudflare.
- [Disposable email check API](https://moemail.app/api/tools/v1/disposable-email/check?domain=mailinator.com): Public, no key, CORS-enabled. `GET /api/tools/v1/disposable-email/check?domain=<domain>` returns `{ "domain", "disposable", "verdict" }`, where `verdict` is `high` (curated list), `medium` (broad aggregated list), `ours` (a MoeMail receiving domain) or `none`. `disposable` is true for all three non-`none` verdicts; to keep false positives low, block only on `verdict === "high"`. `GET /api/tools/v1/disposable-email/dataset` returns list sizes, build time and upstream checksums. Limited to 17 requests per 10 seconds per IP; over the limit you get a plain-text HTTP 429, not JSON.
- [Disposable domain dataset](https://moemail.app/disposable-domains.txt): The merged, deduplicated blocklist as plain text, one domain per line. Compiled from community-maintained upstream lists (CC0-1.0 and MIT); attribution and licences are in the file header.

## Contact

- [Telegram](https://t.me/moecloudflare)