Repolode
Submit
dreamhunter2333

dreamhunter2333/cloudflare_temp_email

Free temporary email service built on Cloudflare Workers, Pages and D1, supporting attachments, IMAP/SMTP and a Telegram bot.

Open-source alternative to:Temp MailGuerrilla Mail

View on GitHubWebsite
Stars
12,064
Forks
8,044
Open issues
23
Last commit
17 hours ago

What is it?

Cloudflare Temp Email is a self-hosted temporary mailbox service that runs on Cloudflare's free tier. Incoming mail is routed through Cloudflare Email Routing to a Workers backend, stored in D1, and viewed through a Vue 3 web frontend deployed on Cloudflare Pages. It supports creating random subdomain addresses under a base domain, reading attachments, and sending mail via SMTP or Resend with DKIM.

Beyond the web interface, the project offers an SMTP proxy server for sending and IMAP access to received mail, plus a Telegram Bot with push notifications and webhook integration. Users can protect addresses with passwords, sign in via OAuth2 or Passkey, and rely on spam filtering with allow/block lists. An admin console handles user roles, domain configuration, scheduled cleanup and rate limiting.

Mail parsing uses a Rust WASM module, and an optional AI step extracts verification codes and links using Cloudflare Workers AI. The project also includes an agent skill so AI assistants can read temporary inboxes.

Key features

  • 01Random subdomain temporary addresses under a configurable base domain
  • 02Attachment viewing and S3 attachment storage
  • 03Sending mail via SMTP or Resend with DKIM verification
  • 04SMTP proxy for sending and IMAP access to received mail
  • 05Telegram Bot, push notifications and webhooks
  • 06OAuth2 and Passkey login, address passwords, and spam filtering

Use cases

  • Signing up for services that require email without exposing a personal inbox
  • Receiving verification codes during development or testing
  • Running a private temporary-mail service on a personal Cloudflare account
  • Giving AI agents a disposable inbox to read verification emails

Quick start

  1. 1

    Read the deployment docs (install guide)

  2. 2

    Deploy to Cloudflare Workers with the one-click deploy button or GitHub Action

Things to know

  • Runs on Cloudflare Workers, Pages and D1, so you need a Cloudflare account and must self-host it.
  • Some features such as SMTP/IMAP proxy need a separate Python server, and AI email extraction depends on Cloudflare Workers AI.

In collections

Self-hosted apps

Topics

#email#cloudflare-workers#temporary-email#self-hosted#typescript#telegram-bot#imap-smtp#cloudflare-email#cloudflare-pages#free

FAQ

What is cloudflare_temp_email?
Free temporary email service built on Cloudflare Workers, Pages and D1, supporting attachments, IMAP/SMTP and a Telegram bot. Cloudflare Temp Email is a self-hosted temporary mailbox service that runs on Cloudflare's free tier. Incoming mail is routed through Cloudflare Email Routing to a Workers backend, stored in D1, and viewed through a Vue 3 web frontend deployed on Cloudflare Pages. It supports creating random subdomain addresses under a base domain, reading attachments, and sending mail via SMTP or Resend with DKIM.
Is cloudflare_temp_email free to use? What license does it have?
cloudflare_temp_email is open source under the MIT license. Check the license terms before using it in commercial products.
Is cloudflare_temp_email still maintained?
Actively maintained. The last commit to cloudflare_temp_email was on Nov 5, 2026.
What can I use cloudflare_temp_email for?
Signing up for services that require email without exposing a personal inbox Receiving verification codes during development or testing Running a private temporary-mail service on a personal Cloudflare account Giving AI agents a disposable inbox to read verification emails
How do I install cloudflare_temp_email?
Read the deployment docs (install guide) Deploy to Cloudflare Workers with the one-click deploy button or GitHub Action
Where can I get cloudflare_temp_email?
The source code and installation instructions are on GitHub: https://github.com/dreamhunter2333/cloudflare_temp_email

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects