What it does
One inbox for every IMAP account, with Gmail-style conversations and shortcuts, search, tags, Snooze, Undo Send, schedule send, templates, and changes made offline that go out in order. A calendar and contacts sync over CalDAV and CardDAV, and with Outlook, tasks sit in the calendar, and Chats shows iMessage, plus WhatsApp, Telegram, and Signal through Beeper, next to the mail. With AI, it summarizes, translates, and drafts replies, labels new mail, and takes requests in plain words, like "move newsletters older than a month to Trash".
How it works
A release
- A version tag starts a build on GitHub's Mac runners
- It's signed with the Developer ID, notarized by Apple, and checked
- Installed copies download it from the website and check the signature
- Three processes. The window is React in a sandbox with no access to the system. The main process handles the Keychain, notifications, menus, and AI requests, and checks every message from the window against a schema. A sync worker in its own process does all the IMAP, SMTP, CalDAV, and database work.
- Sync: two IMAP connections per account, one waiting for new mail and one for fetching and actions. Changes show at once, wait out an undo window, and replay in order after time offline.
- Storage: SQLite encrypted with SQLCipher, its key kept in the macOS Keychain, with a full-text index for search.
- Email is treated as hostile: cleaned with DOMPurify and shown in a sandboxed frame with no scripts, with remote images blocked until allowed and tracking pixels never loaded.
- Chats: iMessage comes from the Mac's own Messages database, opened read-only, and replies go out through Messages. WhatsApp and the other networks come through Beeper Desktop's API on the same Mac.
- AI: OpenRouter with your own key, or a model running on the Mac through Ollama or LM Studio.
- Releases: GitHub's Mac runners sign each version with my Developer ID, and Apple notarizes it. The website, a Cloudflare Worker, serves downloads and update checks from R2, and installed copies update themselves.
Decisions that shaped it
- No Mailroom account and no Mailroom server. The Mac talks straight to the mail provider.
- Play well with other devices. Flags, folders, drafts, and tags live on the server, and Mailroom never sends a bare EXPUNGE that could delete another app's mail.
- Keep secrets on the Mac. Passwords and sign-in tokens are encrypted with the Keychain, and Google, Microsoft, and Yahoo tokens only go to their own mail servers.
- AI only when you ask for it or turn it on, with the model of your choice, including one running locally.
- The Assistant proposes, Mailroom decides. Its model can search and suggest a change, but Mailroom counts the mail that change would touch, shows it on a card, and applies it only when you click, with Undo.
- Electron, not native. Every HTML email is a small web page, so even Apple Mail shows mail with a web engine. Electron keeps the interface and the sync engine in one TypeScript codebase that could reach Windows later. The cost is a 238 MB download, mostly Chromium built for both Intel and Apple silicon.
- A second look before big releases. A separate review of each big feature's code found two serious bugs in Auto Labels after every test had passed, one of which would have sent a new account's whole Inbox history to the AI. That version was never published. Before 0.19, a review stopped a build that could have lost an Outlook contact's photo and addresses, or a change made on a phone. Before 0.20, one found that a scheduled email you took back could still have gone out, and before 0.21, that a reply you'd just sent could come back as a draft at the moment it went, where clicking it would have sent it twice.
- The signing key never touches a laptop. It lives in a password manager and the build's secrets.
How it came together
- October 3, 2026: the brief, then a plan with the folder structure and database schema, approved before any code.
- October 4, overnight and morning: the app shell, read-only sync, actions with undo and push, compose and send, and tags and search, each tested against mail servers running in Docker.
- October 4, afternoon: the calendar, testing on a real Purelymail account, the first installable build, then print, translation, summaries, invitations, and contacts.
- October 4, evening: sign-in with Google, Microsoft, and Yahoo, settings detection, appearance settings, Developer ID signing and notarization, a website with downloads, and automatic updates.
- October 5: a domain of its own, getmailroom.dev, with a help center and a help bot, plus Snooze, sending from other addresses, Google and Outlook calendars, and Proofread.
- October 6: tasks, one Google sign-in for mail and calendar, and Gmail's own ways of archiving, drafting, and showing message text.
- October 7: Chats with iMessage and Beeper, AI replies in chats, tasks in the calendar's week view, and images that load when you choose, with tracking pixels blocked.
- October 8: Auto Labels, the Assistant, a narrated demo film recorded by scripts that drive the app, and a support address, support@getmailroom.dev.
- October 9: Mailroom's own Sign in with Microsoft and Google, after the first support email showed that Microsoft no longer lets a personal account register an app of its own. Then the everyday Gmail features it still lacked, like selecting a whole folder, formatting, and downloading all attachments at once, and Outlook contacts.
- October 10: schedule send, templates, muting and blocking, saved searches, inbox tabs, and starting chats, with notifications for new messages. Then, from a user's feedback, pictures you can insert and resize, toolbar buttons you can take off, a text size for each part of the window, and writing in a window of its own.
- Along the way: 49 releases, 223 commits, about 57,000 lines of TypeScript, 787 unit tests, and 108 integration tests against Dovecot, Mailpit, and Radicale.
Where it is now
Live at getmailroom.dev, free for macOS 13 or later on Apple silicon and Intel, with a two-minute demo at getmailroom.dev/demo/. Questions go to support@getmailroom.dev.
