// Apple Mail · one-command connect

Connect every inbox on your Mac to AI, in one command.

Operators who live in email already have seven or eight accounts aggregated in Apple Mail on one Mac. RadMail's local connector connects all of them at once— no per-account OAuth, no forwarding rules, no shared passwords. It reads the mail Apple Mail already collected and hands it to RadMail's brain: the Right Now lane, the open commitments, and drafts you review — with the BEC hard-stop unchanged.

RadMail is pre-release, with its engine live in a test bed on two real businesses. The connector reads metadata and normalized text only — attachment contents are never read — and it is ingest-only: it cannot send. It needs a RadMail account with write scope and Node on the Mac; a one-line installer is a planned follow-up.

What the one command does.

radmail :: apple-mail connector
  • Discovers every accountReads the accounts Apple Mail already aggregates on the Mac — interactively, or non-interactively with --yes --all — so every inbox is covered at once.
  • Installs a background watcherCopies its runtime out of the checkout and installs a small launchd agent that scans your inbox on an interval, then runs the first scan immediately.
  • Ingests metadata + text onlyParses each new message (multipart, quoted-printable, base64, RFC-2047 subjects, html→text) into normalized text. Attachment contents are never read.
  • Dedupes by Message-IDEvery message is idempotent end to end, so it runs safely alongside a server-side Gmail/Outlook connection without creating duplicates.

A Mac-side connector inherits the Mac's sleep schedule. For an inbox where nothing can wait even minutes, connect that mailbox server-side as well — the two run together, and Message-ID dedupe keeps them from doubling up.

Built for the person with eight inboxes.

The whole point of Apple Mail is that it already gathers every account in one place. The connector meets you there: one command, and RadMail is triaging the entire pile — ranking each message on importance and urgency, surfacing the few that genuinely can't be missed, extracting the commitments you owe and are owed, and drafting replies for your review. Nothing about it loosens the hard-stop: money, new banking, and first contact stay human-only, forever.

Common questions.

How do I connect Apple Mail to RadMail?

RadMail ships a local Apple Mail connector you run once on your Mac. It discovers every account already aggregated in Apple Mail, installs a small background watcher, and starts ingesting your inbox mail into RadMail over RadMail's API. There is no per-account OAuth, no forwarding rule, and no password to share — the connector reads Apple Mail's local store directly on your machine. It needs a RadMail account with write scope, and RadMail is pre-release, so this is early-access.

tl;dr Run one command on your Mac; it connects every account Apple Mail already holds.

Does the Apple Mail connector read my attachments or send anything?

No. The connector reads message metadata and normalized text only — attachment contents are never read, just noted. It is an ingest-only path: it moves mail into RadMail so RadMail can triage it, surface commitments, and draft replies for your review. It never sends on your behalf, and RadMail's BEC hard-stop is unchanged — money, new banking, and first contact stay human-only, forever.

tl;dr Ingest-only, metadata + text (never attachment contents), and it cannot send.

Is it safe to run the Apple Mail connector alongside a Gmail or Outlook connection?

Yes. The connector is Message-ID idempotent end to end, so if the same message arrives through both the Apple Mail connector and a server-side OAuth connector, RadMail recognizes it as one message and does not duplicate it. You can connect a Mac's local inboxes and cloud mailboxes at the same time.

tl;dr Message-ID dedupe means no duplicates when it runs beside server-side connectors.

Why connect Apple Mail instead of connecting each account separately?

Operators who live in email usually have seven or eight accounts already aggregated in Apple Mail on one Mac. Connecting them individually means seven or eight OAuth flows, forwarding rules, or shared passwords. One local connector covers all of them in a single command, because it reads the mail Apple Mail already collected — the easiest onboarding path for a multi-inbox operator on a Mac.

tl;dr One command covers every inbox Apple Mail already aggregates — no per-account setup.

What are the limits of the Apple Mail connector?

It is a Mac-side connector, so it inherits the Mac's sleep schedule — if the Mac is asleep, mail is picked up when it wakes. For inboxes where nothing can wait even minutes, connect that mailbox server-side as well. It currently needs Node and a RadMail account with write scope; a one-line installer for people without Node is a planned follow-up. RadMail is pre-release, with its engine live in a two-business test bed.

tl;dr It follows the Mac's sleep schedule; pair 24/7-critical inboxes with a server-side connect.

Start on the Mac you already have. Create a RadMail account, then run the connector once to bring every Apple Mail inbox under one brain.

› Start free — no card
radmail@inbox:~$ radmail connect --apple-mail --all