TempMail OTP — Self-Hosted Temporary Email Generator
Receive-only temp email server with automatic OTP extraction for security research, QA automation, and disposable identity workflows.
Features
- SMTP catch-all (port 25) → SQLite, automatic OTP / link extraction
- Real-time inbox via SSE stream
- REST API (x-api-key auth) + MCP server for AI agents (Hermes, Claude, etc.)
- Optional Cloudflare Worker for cloud email ingestion (D1) — app falls back to it when local SQLite is empty
- Docker deployment (Next.js standalone + SQLite volume)
Architecture
Layered Next.js 14 app:
core/— domain entities + pure logic (otp-extractor, email-parser, errors)data/— persistence (db, schema.sql, migrate, queries)shared/— cross-cutting (env, logger, events, api-helpers, dns-check)infrastructure/— external adapters (smtp, mcp)app/— UI + REST API (required location for Next.js standalone build)cloudflare-email-worker/— separate deployable (wrangler) for cloud ingestion
Getting started
See README.md and docs/ (dns-setup, deployment, troubleshooting, hermes-integration, workflow-examples).