Email for youand your agents.
Airpost is an open-source mail client for macOS and Linux. A Rust engine on your computer syncs your accounts, and the desktop app, the terminal, AI agents and the web all go through it. You don't need an Airpost account.
brew install airpost-mail/tap/airpostInbox
8Lisbon office: lease to countersign
Hi Sam,
The landlord signed this morning, so it's only your signature left. Can you countersign by Friday? Then the keys are ready on the 1st and the movers can come the same week.
I left two notes on page 4 about the parking spaces. Nothing that blocks signing.
Thanks, Maya
Try itJK to move,E to archive,S to star,# to trash,Z to undo.
- GmailMicrosoft 365Outlook.comiCloudFastmailYahooZohoany IMAP and SMTP server
- Agents
- Claude CodeCodexClaude Desktopany MCP client over stdio or HTTP
- AI, if you want it
- your OpenAI-compatible or Anthropic keyOllamaLM Studiollama.cpp
It's all one engine.
The Airpost engine is the only program that touches your mail. It holds your accounts, the mail and its search index, and everything else is a client of it. The app, the airpost command, an agent and a browser all see the same mail, rules and undo history.
An agent stars Maya's lease through airpost-mcp.
An animated example: an agent stars a thread, you archive one in the app, and the terminal undoes the archive. Each change goes through the engine and shows up in the other windows.
On the way:TUIiPhoneDevice sync
- One process
- It holds every account and serves every client, and can keep running after the app quits, so scheduled sends still go out.
- A private socket
- Clients talk JSON-RPC over a Unix socket that only your user can open, so nothing goes over the network and there's no login.
- Live queries
- Every client sees changes as they land, and one undo log keeps track of what each of them did.
A mail client you can live in.
Threads, labels and folders that match how your provider works, search operators, and the features that usually need a subscription, all running on your computer.
Search with a grammar
from:, to:, subject:, in:, is:, has:attachment, before: and after: with dates like “3 days ago” or 2w, plus AND, OR, NOT and parentheses. Edit the query above.
Undo send
A few seconds to change your mind after you hit send. Try the button.
Snooze, send later, reminders
The engine keeps the schedule, so a snoozed thread comes back and a scheduled send goes out with the window closed.
All your accounts in one inbox
Gmail and Microsoft sign in with OAuth, and the rest use IMAP. Airpost finds the server settings for most providers.
Every action has a key
Gmail-style shortcuts, or the Outlook or Apple Mail set. Press ? in the app for the full list.
Calendar and contacts
CalDAV and CardDAV, with Google contacts through the People API. Answer invitations from the message.
Rules, templates, signatures
The engine runs your rules on arriving mail, with or without the app open. Templates and signatures follow every draft, the CLI's and your agent's included.
One-click unsubscribe
Uses the sender's own List-Unsubscribe header: one click when it supports that, an email when it doesn't.
Maya needs your countersignature on the Lisbon lease by Friday so the keys are ready on the 1st. Two notes on parking, page 4, nothing blocking.
- Off by defaultNothing runs until you add a model.
- Your own keyOpenAI-compatible or Anthropic.
- Or a local modelOllama, LM Studio, llama.cpp.
Optional AI
Thread summaries, reply suggestions and inbox sorting, through a provider you choose. Your mail only goes to the model you set up.
Plugins and themes
Six bundled themes, the plugin system Mailspring plugins already use, and service plugins that run next to the engine.
Private from the first launch.
There's no Airpost server between you and your mail. It goes straight between your computer and your provider, and the privacy options are on from the start.
No Airpost account
Download it and add your mail account. There's nothing to sign up for.
Remote images blocked
Images from the web stay off until you load them, so senders can't tell when you open a message.
Tracking pixels stripped
Pixels from known trackers are taken out of incoming mail.
Phishing warnings
When the reply-to address doesn't match the sender's, you see it before you reply.
No Gravatar lookups
Airpost doesn't fetch contact photos from Gravatar unless you turn it on, since that means sending it your contacts' addresses.
Credentials stay in the engine
Passwords and tokens live in the engine, behind a socket only your user can reach.
- <img src="https://open.esp-mailer.example/o/8f2a…/1x1.gif" width=1 height=1>
- <img src="https://pixel.newsletters.example/t.png?u=sam…" width=1 height=1>
- <img src="https://t.click-metrics.example/open?id=0be3…" width=1 height=1>
Let agents work your inbox, within limits you set.
airpost-mcp gives Claude Code, Codex, Claude Desktop or any MCP client 38 tools for mail, calendar and contacts. Every call is checked against the access level, accounts and folders you allow, and written to an audit log.
airpost-mcp install --client claude-codeWrites one airpost entry in the client's config and nothing else. Or flip the switch in Preferences › MCP.
"accessLevel": "read-write"| time | client | toolName | outcome | ms |
|---|---|---|---|---|
| waiting for the first call… | ||||
38 tools, three levels
Attachments are also resources (attachment://{messageId}/{fileId}). Over stdio for local apps, or streamable HTTP with a bearer token.
Mail is untrusted input
The server's instructions tell agents never to follow instructions found in mail, and to confirm before sending or changing many threads at once.
Undo, for its own changes
An agent can take back what it archived, moved, labeled or snoozed. What you did in Airpost stays yours to undo.
Or hand it the CLI
airpost skill install adds a skill for Claude Code and Codex. The CLI has your full access, like you at your terminal.
Your mail in the terminal.
The airpost command reads and changes the same mail as the app: search, threads, drafts, snooze, rules, calendar, contacts and a live watch. It talks to the engine over its socket, with no login.
- --json on everything. One JSON document per command, NDJSON for streams, and exit codes to script against.
- Bulk changes you can undo. Archive, label or move every match of a query, check it with --dry-run, and take it back with airpost undo.
- Services it manages. airpost engine install runs the engine as a launchd or systemd user unit, started at login.
- A TUI is on the way. A full-screen terminal client on the same engine is being built.
airpost engine installYour own Airpost server.
The server is one Docker image and one compose file. The engine runs there, so mail keeps syncing and scheduled sends go out with every device off. The web client and remote MCP are one compose profile each.
From airpost-gateway pair. A code works once, for at most an hour.
enginealways onSyncs your accounts and keeps their credentials.
gatewayprofile: webAirpost on the web, for browsers you pair.
caddyprofile: proxyTLS for your domain. Leave it out behind your own proxy.
backendprofile: backendMetadata sync between your desktops. Not available yet; leave it off.
mcpprofile: mcpAgents reach your mail at /mcp with a bearer token.
AIRPOST_DOMAIN=mail.example.comAIRPOST_VERSION=0.1.0COMPOSE_PROFILES=web,proxy
Runs with your laptop closed
Scheduled sends, snoozes and rules keep running on the server.
Credentials stay with the engine
Each part runs in its own container. The key to your mail credentials is on a volume only the engine mounts.
Your mail in any browser
Pair a browser with a one-time code. Every paired device is listed, and you can revoke any of them.
Providers on one side, clients on the other.
The engine talks IMAP, SMTP and DAV to your providers and JSON-RPC to everything else. Each client is its own program, and launchd, systemd or Docker keeps them running.
Written in Rust.
A translation of Mailspring's C++ sync engine, split into 19 crates, with fuzz targets for the MIME, IMAP, iCalendar and vCard parsers.
airpost-imapThe IMAP session the sync workers and tasks drive.
airpost-smtpSending, and the SMTP check when you add an account.
airpost-mimeMIME parsing, body rendering, snippets, the outgoing message builder.
airpost-storeSQLite: schema, queries, transactions and the delta stream.
airpost-syncBackground scans, foreground IDLE, metadata, calendar and contacts.
airpost-tasksThe local and remote phases of every task a client queues.
airpost-composeDrafts as the desktop builds them: quoting, signatures, send warnings.
airpost-davCalDAV and CardDAV: XML, vCard, iCalendar and discovery.
airpost-pimRecurrence, RSVP and counter-proposals, VCF import and export.
airpost-aiSummaries, replies and triage over OpenAI-compatible, Anthropic and Ollama APIs.
airpost-secretsThe OS keychain, Secret Service, or an AES-256-GCM file.
airpost-ipcJSON-RPC 2.0 over newline-delimited JSON on a Unix socket.
airpost-clientDiscovery, hello, the multi-engine router and typed calls.
airpost-providersProvider quirks, folder roles and OAuth endpoints.
Pick how you run it.
Install the desktop app, the command-line programs or your own server. Everything is free under GPL-3.0, and there's no account to create.
The first release is on its way. The package commands work once it's out; until then, building from source takes four commands.
Node from .node-version, Rust (pinned by the repo), Python 3 and a C/C++ toolchain. make desktop runs on a sandbox profile and never touches your real one; make mail adds fake accounts to try it on.
- 1
git clone https://github.com/airpost-mail/airpost.git - 2
cd airpost && make setup - 3
make desktop - 4
make mail
Good to know.
Something else? Open an issue on GitHub.
Try Airpost with your own mail.
Free and open source, for macOS and Linux. Add an account and you're done.