Postern
EN

Your mailbox, behind a door you hold.

Let AI apps work with your Proton Mail, on your Mac. Nothing is sent or deleted until you approve it with Touch ID.

Download for Mac
brew install --cask ruben4reall/tap/postern

Free and open source. Made in Switzerland, in Valais. macOS 26 or later, with Proton Mail Bridge.

An animation: in Claude Code, you ask for a reply to Anna with the signed contract. Postern opens its approval panel with the whole email, its recipient and its attachment with a SHA-256 fingerprint. You choose Send with Touch ID, touch the sensor, and the email leaves.

How a request reaches your mailbox.

An AI app never touches Bridge, your password or your settings. It talks to a relay that holds nothing, and Postern decides, with you.

The path of a request: the AI app, then the postern-mcp relay over stdio, then the Postern app over XPC with signatures checked both ways, where you approve with Touch ID, then Proton Mail Bridge over TLS with a pinned certificate.
  1. The app asks. Claude Code calls reply_to_message, one of the tools you turned on.
  2. The relay carries it. postern-mcp passes it to Postern over XPC. It holds no secret and decides nothing.
  3. Postern checks, you approve. The switch, your limits and the recipients are checked, then the panel shows you the email. Touch ID says yes.
  4. Bridge sends it. Exactly the approved bytes go to Bridge, over TLS, to the certificate you pinned during setup.

You switch on what they may do.

Postern offers 27 tools in five tiers. Every switch starts off. A tool that is off is not refused, it is absent: the app cannot see it, so it cannot call it.

Turning a tool on asks for Touch ID. Turning it off is immediate, and connected apps see the change at once. Pause stops everything, and Postern can pause itself when your screen locks.

Try the switches. In Postern each tool has its own; here they move a tier at a time.

  • ReadSearch and read mail, cleaned of hidden text.
  • OrganizeRead, star, move, label. Never to Trash or Spam.
  • DraftsWrite drafts. Nothing is sent.
  • SendEvery email waits on the panel for Touch ID.
  • DeleteEach deletion listed on a panel, with Touch ID.

What Claude Code sees8 tools

  • list_mailboxes
  • search_messages
  • get_message
  • get_thread
  • awaiting_reply
  • read_attachment
  • save_attachment
  • list_addresses
Part of an approval panel: the recipient is marked Reply-To differs, First contact and Found in an email, with a red warning that the address appeared inside an email the app read.

ApprovedSHA-256 9d65 8e71 5dcb 02af 6e14…

LeavingSHA-256 9d65 8e71 5dcb 02af 6e14…Same bytes

You see exactly what leaves.

The whole email
Sender, every recipient, the subject, the full text and the quoted part, and every attachment with its size and SHA-256 fingerprint.
Where recipients came from
A first contact, a reply that would go to a different address than the sender's, or an address the app found inside an email it read: the panel says so, in red when it matters most.
Bound to the bytes
Your approval covers a SHA-256 of every byte that leaves. The code that sends accepts nothing else, so nothing can change between what you read and what goes out.
Then Touch ID
A program cannot type it. You can also keep the email as a draft, or reject it with a note for the app. A panel left alone for two minutes means no.

Mail written by strangers is read as data.

A message can hide text you never see but a model does. Postern removes it before the app reads anything, and wraps what is left in markers the sender cannot forge.

On the left, an email as sent, with a hidden instruction to forward invoices, invisible characters and a tracking image. On the right, the same email as the app reads it: the hidden text, invisible characters and image are gone, and the content sits between postern-untrusted markers that carry a random value.

Who really sent it

Each message carries a verdict from what Proton recorded on delivery: internal, verified, unverified or failed. A result the sender wrote into the message to look trusted is caught.

Links as they are

Every link is listed with its real destination, and flagged when its text names another site or its domain mixes scripts.

Attachments in a sealed reader

PDFs, scans and photos are read in a sandboxed process with no network, no Keychain and no files. Scans are recognized on your Mac by Vision; nothing is uploaded.

“Attached” means attached.

An email whose text says a file comes with it, and carries none, is stopped before it is saved or sent. The app is told why, and can add the file.

Codex calls send_message with a body that says the signed contract is attached, and no file. Postern answers attachment_missing: the email says attached but no file is attached, so nothing was done.

It reads the words in eleven languages, in the subject and in what the app wrote, not in the quoted original. When no file is meant, the app says so, and the panel shows it in orange.

  • attached
  • ci-joint
  • pièce jointe
  • anbei
  • adjunto
  • in allegato
  • em anexo
  • bijlage
  • w załączniku
  • 添付
  • 附件
  • 첨부

Three ways to attach a file

  1. From the outboxattachments

    Files you put in ~/Downloads/Postern/Outbox or its folders. Nothing else on your Mac can be attached, and no link is followed.

  2. Written by the appinline_attachments

    A file the app made itself, such as a CSV it built in a chat, passed as text or base64, up to 10 MB.

  3. From an email it reademail_attachments

    Send an invoice on to your accountant without saving it first: the app names the email and the attachment's number.

Up to 20 files and 20 MB per email, in any mix of the three. Every answer names the files that left, with their sizes.

Every saved draft is checked. Postern reads back how many files Bridge kept. If one is missing, the draft is removed and the app hears so, instead of a draft that looks complete and is not.

Up to 5,000 emails. One panel, one Touch ID.

The app writes drafts from a CSV or JSON file, with {{values}} filled in for each person. You check them all on one panel, then a paced queue sends them within your limits.

A spreadsheet of five companies becomes five drafts, each with a CV and its own letter. After one approval, the emails leave thirty seconds apart: three are sent, then the hourly limit is reached and the last two wait for room.
Paced
Two seconds apart for up to 20 emails, thirty above, so a long batch never reaches Proton as a burst. start_at can hold the first one for up to thirty days.
Within your limits
10 per hour and 30 per day by default. When a limit is reached, the batch waits for room instead of failing. Raise them with Touch ID, up to 300 per hour and 1,000 per day, and it speeds up.
Holds when Bridge is down
If Bridge is not running or asks to wait, the batch holds and tries again after 30 seconds, 2 minutes, then every 10 minutes.
Never twice
A draft held or sent by one batch cannot be taken by another, and an app that calls again after a timeout gets no second panel. An email cut off while Bridge took it is never sent again.
Survives a restart
An approved batch is sealed on disk as it goes, under a key in Postern's Keychain. After a restart of the Mac or of Postern, it waits until you choose Resume with Touch ID.
Only what you approved
Each email keeps its own digest. A draft you change in Proton after approving it does not leave, deleting one holds it back, and Stop keeps the rest as drafts.

Proton applies its own sending limits too, and may stop an account that looks like it sends bulk mail. Batches are meant for mail people expect, such as applications or invitations.

Works with the AI app you already use.

Postern speaks the Model Context Protocol, so any MCP client can use it.

  • Claude Code
  • Claude Desktop
  • Codex
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Gemini CLI
  • Kiro
  • Cline

One click

Click Connect in Postern's Apps pane for Claude Code, Claude Desktop, Codex (whose connection ChatGPT's Mac app shares), Cursor, VS Code with Copilot, Windsurf, Gemini CLI, Kiro or Cline. Postern writes one entry in that app's settings: the path of its helper, never a password.

One line for the others

For any other app, Postern gives you the entry to paste in that app's own format, such as Zed, OpenCode, Goose or Continue. Any client that launches an MCP server over stdio can start the same helper.

{
  "mcpServers": {
    "proton-mail-postern": {
      "command": "/Applications/Postern.app/Contents/Helpers/postern-mcp"
    }
  }
}

Each risk, and the lock that answers it.

Postern is built on one rule: nothing an app can reach may open a lock. No setting it can edit, no argument it can fill in, no file it can rewrite, no local port it can call.

Your Bridge password
Lives only in the macOS Keychain, in a group only Postern's signed code can read. App settings hold a path, never a secret.
An app that wants more power
The switches live in the same Keychain group. Only Postern's window writes them, and adding power needs Touch ID.
A program posing as Bridge
Postern pins Bridge's certificate at setup and refuses any other. It never sends your password before the connection is encrypted.
A booby-trapped message
Mail is decoded in a separate process with no network, no Keychain and no files. A crash there makes one message unreadable, nothing more.
Another program talking to Postern
Every connection between Postern's processes checks that the other side is signed by Postern's developer, both ways.
A tampered update
The list of versions and every update are signed with Postern's own key (EdDSA), which never leaves the maintainer's Mac. Nothing installs without your click.
You step away
Postern can pause itself when the screen locks. Resuming asks for Touch ID.
A batch waiting on disk
Sealed with ChaCha20-Poly1305 under a key in Postern's Keychain group: no other program can read who the emails go to, and a changed file does not open. It never resumes on its own.

Two destinations, both named

Postern talks to Bridge on your Mac. The only other connection is the update check, off until you say yes: once a day it reads a signed list of versions on getpostern.vercel.app and downloads updates from GitHub. That reveals your IP address and Postern's version, nothing else. No analytics, no telemetry, no copy of your mail.

The activity log records which app called which tool and when, never what your mail says. Each entry is chained to the one before, so an edited entry shows.

What Postern cannot protect against

  • An email you approve: it leaves.
  • What an app reads once reading is on. Hide the mailboxes you want out of reach.
  • What an app does with what it read.
  • Malware with administrator rights or control of your screen.
  • Bridge itself, and the delivery results Proton records.

Read the full threat model

Set up in a minute.

You need macOS 26 or later and Proton Mail Bridge, signed in, on the same Mac.

  1. Get Bridge ready

    Install Proton Mail Bridge and sign in to your Proton account.

  2. Install Postern

    Download the disk image and drag Postern to Applications. It is signed with a Developer ID and notarized by Apple; its SHA-256 is listed next to it.

  3. Trust Bridge, then sign in

    Postern finds Bridge and shows its certificate's fingerprint. Paste the username and password Bridge shows under Mailbox details: made by Bridge, not your Proton password.

  4. Connect your apps

    Allow reading with Touch ID, then click Connect next to your AI app. Restart it, or open a new session, and ask in plain words.

Download for Mac
brew install --cask ruben4reall/tap/postern

Postern checks for updates once a day if you allow it, and each update waits for your click. It adds a background item that starts it when an app connects, listed in System Settings, General, Login Items.

Questions

What does Postern cost?

Nothing. Postern is free and open source under the MIT license, and its code is on GitHub.

Which Proton Mail plans work with it?

Postern reaches your mailbox through Proton Mail Bridge, so it works with any account that can use Bridge. Proton offers Bridge with its paid plans that include Proton Mail; Proton's Bridge page has the current details.

Does Postern send my data anywhere?

No. Postern talks to Bridge on your Mac and keeps no copy of your mail. The only other connection is the daily update check, and only if you allow it: it reveals your IP address and Postern's version to Vercel and GitHub, nothing else. There are no analytics and no telemetry. What an AI app does with mail it has read is up to that app.

Can an AI app send email without me?

Every email waits on the approval panel and leaves only after you choose Send and pass Touch ID. The one way around the panel is a list of trusted recipients that only you can fill, in Postern's window. You can also restrict sending to a list of allowed recipients.

Can it delete my mail?

Only if you turn on the Delete tools. Each deletion lists every message on a panel and needs Touch ID, and erasing works only on messages already in Trash or Spam.

Which AI apps work with it?

Claude Code, Claude Desktop, Codex, Cursor, VS Code with Copilot, Windsurf, Gemini CLI, Kiro and Cline connect in one click. For any other MCP client that launches a server over stdio, Postern gives you the entry to paste in that app's format.

What if Bridge stops in the middle of a batch?

The batch holds and tries again after 30 seconds, 2 minutes, then every 10 minutes. Nothing is lost: a draft leaves Drafts only once its email is sent, and an email whose connection broke while Bridge was taking it is never sent again by a batch. If the Mac restarts, the batch comes back and waits for you to resume it with Touch ID.

How does Postern update itself?

With Sparkle. Postern asks once whether to check daily, and Check for Updates works either way. The list of versions and every update are signed with Postern's own key, checked before anything opens, and nothing installs until you click Install and Relaunch.

Does Postern speak my language?

Postern's window, menus and approval panels are in English, French, German, Spanish, Italian, Portuguese, Dutch, Polish, Japanese, Chinese and Korean, and follow the language of your Mac. Your AI app can read and write email in any language.

Is Postern made by Proton?

No. Postern is an independent project by Ruben Catalao, made in the canton of Valais, in Switzerland, like Proton is Swiss. It is not affiliated with or endorsed by Proton AG.

Open the door when you choose.