MailerSelf-hosted mail notifications

Watches your IMAP mailboxes over IDLE and forwards new mail to Telegram or Discord — with your own parsing rules and no third-party server in the middle.

Get started

Gmail OAuth2 setup

Runs on your own machine

A single static binary. Your mailbox credentials and message contents stay on the host you control; there is no hosted service operated by this project.

Instant delivery over IMAP IDLE

Connects with IDLE so new mail is forwarded as it arrives, rather than on a polling interval.

Pluggable parsing

Extract one-time codes or specific fields with host-side regular expressions, or with sandboxed WebAssembly plugins that have no file, network, or environment access.

No duplicate notifications

Message-ID deduplication and a persistent retry queue survive restarts, so nothing is announced twice and nothing is silently dropped.

What this site is

This is the documentation site for the Mailer project. It also hosts the two pages Google requires before an OAuth consent screen can be published:

Both apply to the self-hosted software itself. Mailer is not a hosted service: there is no account to create, and the project does not operate a server that receives your mail.