MailRules

Sorts incoming email over IMAP, in real time, using rules you write in plain English or as structured conditions - a self-hosted mail filter with an AI model…

  • AI
  • Automation
  • Productivity
  • Tools & Utilities
Sorts incoming email over IMAP, in real time, using rules you write in plain English or as structured conditions - a self-hosted mail filter with an AI model deciding which rule an email matches. Works with any IMAP mailbox that signs in with a password or app password (iCloud, Gmail, Fastmail, Yahoo, Zoho, your own server). Outlook.com and Microsoft 365 are not supported by the self-hosted build. Choose the model that decides: a local Ollama server on your LAN (nothing leaves your network), any OpenAI-compatible endpoint, Anthropic, or the hosted Jev/Clef models. Rules made only of conditions, and sender rules, need no model at all. It starts safe: dry-run is on, so it records what it would do and changes no mailbox until you switch dry-run off. It never deletes mail, and every action can be undone for 30 days.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

46/100 Fair

Maintained
79last commit 26 days ago
Popular
144 GitHub stars
Easy to install
201 install platform, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today

GitHub stars
4
Open issues
0
Last commit
2026-10-26
Latest release
v0.3.0
License
AGPL-3.0
Activity
declining

Checked 2 days ago - source: GitHub (TurtleByte-IN/mailrules)

Resources & Compatibility

Requirements not published yet.

Checked 2 days ago - source: Docker Hub image tags and published docs

First-install notes

No first-install notes yet.

Alternatives

No alternatives collected yet.

Common questions

Will MailRules start changing my inbox immediately after I connect my mailbox?

No, dry-run is on initially. It records what it would do until you switch dry-run off.

Do I have to create an app password, and will MailRules mark incoming mail as read?

You sign in with an app password. MailRules uses IMAP IDLE and reads without marking anything read.

Can I use Ollama as the decision model instead of the other model providers?

Yes, the docs list Ollama and OpenAI-compatible endpoints as decision-model options. Rules made only of conditions do not need a model.

How can I migrate or back up my rules between instances?

Rules can be exported as YAML and imported back.

Do I need to configure a reverse proxy for local use?

MailRules listens on the local machine only by default. The security section covers putting it behind a reverse proxy when needed.

Answers sourced from mailrules.app, mailrules.app

Community

Collected 2 days ago - public community threads