aMail_

Open source · MIT · self-host

Mail for you.
And for your agents.

aMail is an agentic multi-inbox mail client. It holds every account in one place and gives agents one authenticated connection to all of them. You run it. The Omarchy plugin puts the same queues on the desktop.

Star aMailStar the Omarchy pluginFollow nova-centauri

Star the repoThen clone it, or install the plugin.Talk to aMail from your agent

  • MIT licensed
  • self-host it
  • MCP at /mcp
  • analyzed ≠ unread
  • unified inbox
  • Omarchy plugin
  • remote content blocked
  • credentials encrypted at rest

Every inbox. One desk.

Agents finish the inbox. You keep your read state.

Human unread and agent analyzed are separate flags. An agent asks for is:unanalyzed, does the work, marks it analyzed. Nothing is handled twice; nothing you have not read gets silently “read”.

  • Threading from Message-ID / References
  • FTS5 search with operators, snooze, star, archive
  • Explainable smart views: Primary, GitHub CI, Ops errors
  • Remote content blocked until you ask
All features
inbox · 4 accountsis:unanalyzed
  • ●ci@githubdeploy.yml failed on main[ops error]
  • ●maya@studioRe: invoice + next sprint[primary]
  • ○watchtower3 images updated overnight[status]
  • ●alerts@labIMAP IDLE caught up on 4 accounts[status]
  • ○ana@labPasskey unlock works on X220[primary]
$ list_messages q="is:unanalyzed" → get_thread → message_action analyzed
NORMAL12 unanalyzed

[01]What it is

A real mail client, agentic first

Unified IMAP/SMTP inboxes for humans — plus an analyzed flag and a single authenticated MCP/REST door so agents can triage without trampling your read state.

[02]How you run it

Open source. You host it.

Clone it, Docker it, keep it. MIT, free forever on your iron. Same client on a VPS, a home box, or the Omarchy plugin’s server mode.

[03]On the desktop

Omarchy plugin

Bar badges for unread and not-analyzed, a triage panel, client or server mode. Same product, closer to the metal.

for humans

IMAP / SMTP · many accounts

Every inbox. One desk.

Gmail, iCloud, Outlook, Mail-in-a-Box, or custom IMAP/SMTP — all under one client. Threading, compose, attachments, shortcuts. A mail client, not a chatbot with an inbox glued on.

accounts

as many as you connect

human flag

unread

agent flag

analyzed

Unified inbox
for agents

One endpoint. Analyzed once.

Point the agent at your instance.

MCP is Streamable HTTP at /mcp on the aMail you run — loopback, a reverse proxy, whatever you expose. Same token as the REST API. This marketing site does not host your mail.

agent session
$ connect http://127.0.0.1:3080/mcp
→ tools/list mail tools · Authorization: Bearer
  aMail: open-source agentic mail. you run the box.
$ list_messages q="is:unanalyzed"
→ 12 results
$ message_action analyzed by="triage-agent"
Talk to aMail from your agent

Desktop

Omarchy plugin. Pick a theme, change everything.

A desktop plugin for aMail: bar badges for unread and not-analyzed, a triage panel, and client/server modes. Same product, closer to the metal.

This site wears the same theme names as your Omarchy desktop. Press T to flip through them — the choice sticks in this browser.

Star the Omarchy plugin

aMail

Clone it. Run it.

Docker, loopback-only by default, upgrade-in-place from GigaMail. Unlimited analyzed mail on your iron.

$ git clone https://github.com/nova-centauri/aMail
$ docker compose up -d
→ http://127.0.0.1:3080 · your instance
Star aMail on GitHub

Omarchy

Install the plugin.

Client mode follows an aMail you already run. Server mode installs aMail on the desktop as a systemd user service.

$ omarchy plugin add https://github.com/nova-centauri/aMail-agentic-mail-omarchy.git --enable
→ bar badges · triage panel · /mcp
Star the plugin on GitHub

Star it. Clone it. Run it.

aMail and the Omarchy plugin are open source. Follow nova-centauri if you want the next commit in your feed.

Star aMailStar the Omarchy pluginFollow nova-centauri