Pre-releaseOpen source, GPL-3.0.

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/airpost
Inbox · Airpost

Inbox

8
Search/

Try itJK to move,E to archive,S to star,# to trash,Z to undo.

Mail
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
§ 01One engine

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.
§ 02The desktop app

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.

Reads asfrom mayahas an attachmentreceived on or after 2w

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.

To maya@okafor.studio
Re: Lisbon office: lease to countersign
Signed, it's on its way back.
Sending in 5 seconds

Undo send

A few seconds to change your mind after you hit send. Try the button.

Snooze until…
Later today18:00
TomorrowTue 09:00
This weekendSat 09:00
Next weekMon 09:00

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.

Gmaillabelssynced
Microsoft 365folderssynced
FastmailIMAPsynced
mail.yourdomain.comIMAP · SMTPsynced

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.

Jnext
Kprevious
Earchive
#trash
Rreply
Areply all
Fforward
Ccompose
/search
G Iinbox
Llabel
?all keys

Every action has a key

Gmail-style shortcuts, or the Outlook or Apple Mail set. Press ? in the app for the full list.

Week of 16 November
MonStandup
Tue
WedLease signing
ThuLIS → BER
Fri

Calendar and contacts

CalDAV and CardDAV, with Google contacts through the People API. Answer invitations from the message.

Mail rule · on arrival
if from ends with @ledger-books.example
then label Receipts
and archive, mark read

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.

HC
Hangar Coffee
Your next roast ships tomorrow
List-Unsubscribe: <https://…>, <mailto:…>

One-click unsubscribe

Uses the sender's own List-Unsubscribe header: one click when it supports that, an email when it doesn't.

Summarylocal model

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.

I'll sign tomorrowCan we talk parking first?
  • Off by default
    Nothing runs until you add a model.
  • Your own key
    OpenAI-compatible or Anthropic.
  • Or a local model
    Ollama, 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.

Light
Dark
Darkside
Less Is More
Taiga
Automatic

Plugins and themes

Six bundled themes, the plugin system Mailspring plugins already use, and service plugins that run next to the engine.

§ 03Privacy

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.

HC
Hangar Coffee
Your next roast ships tomorrow
3 trackers removed · remote images blockedLoad images
  • <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>
hero.jpg, not loaded
§ 04Agents

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.

Connect an agent
airpost-mcp install --client claude-code

Writes one airpost entry in the client's config and nothing else. Or flip the switch in Preferences › MCP.

Access level"accessLevel": "read-write"
Visible
sam@fastmail.com
sam@northwind.co
Hidden
Northwind › Legal
Personal › Health
Agent session· Claude Code → airpost-mcp
mcp-audit.log· what each agent read, drafted or sent
timeclienttoolNameoutcomems
waiting for the first call…

38 tools, three levels

Read mailRead and draftRead, draft and send
list_accountslist_folderssearch_maillist_threadsget_threadget_messageget_attachmentlist_templateslist_eventsget_contactlist_scheduled_sendsget_message_trackinglist_tracked_messagesget_top_linkscreate_draftreply_to_threadupdate_draftdelete_draftarchive_threadstrash_threadsmove_to_folderset_labelscreate_labelset_unreadset_starredsnooze_threadsunsnooze_threadsundoset_remindercancel_scheduled_sendcreate_eventupdate_eventcreate_contactupdate_contactundosend_draftschedule_sendunsubscriberespond_to_event

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.

§ 05Terminal

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 install
sam@studio: ~
❯
❯
§ 06Airpost server

Your 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.

mail.example.com/pair
Pair this browser
K7QM2X

From airpost-gateway pair. A code works once, for at most an hour.

deploy/server/compose.yamlone person per server, for now
  • enginealways on

    Syncs your accounts and keeps their credentials.

  • gatewayprofile: web

    Airpost on the web, for browsers you pair.

  • caddyprofile: proxy

    TLS for your domain. Leave it out behind your own proxy.

  • backendprofile: backend

    Metadata sync between your desktops. Not available yet; leave it off.

  • mcpprofile: mcp

    Agents reach your mail at /mcp with a bearer token.

.env
AIRPOST_DOMAIN=mail.example.com
AIRPOST_VERSION=0.1.0
COMPOSE_PROFILES=web,proxy
$docker compose up -d
$docker compose exec engine airpost account add you@example.com
$docker compose exec gateway airpost-gateway pair

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.

§ 07How it fits together

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.

Your providers
Gmail, Microsoft 365, any IMAP server, SMTP, CalDAV and CardDAV
airpost-engine
credentials, mail database, search, schedules, undo
Desktop app
Electron · macOS, Linux
airpost
the CLI · skill for agents
airpost-mcp
stdio · streamable HTTP
airpost-gateway
→ the web client
TUI
scheduled
iOS
scheduled
The engine

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-imap

The IMAP session the sync workers and tasks drive.

airpost-smtp

Sending, and the SMTP check when you add an account.

airpost-mime

MIME parsing, body rendering, snippets, the outgoing message builder.

airpost-store

SQLite: schema, queries, transactions and the delta stream.

airpost-sync

Background scans, foreground IDLE, metadata, calendar and contacts.

airpost-tasks

The local and remote phases of every task a client queues.

airpost-compose

Drafts as the desktop builds them: quoting, signatures, send warnings.

airpost-dav

CalDAV and CardDAV: XML, vCard, iCalendar and discovery.

airpost-pim

Recurrence, RSVP and counter-proposals, VCF import and export.

airpost-ai

Summaries, replies and triage over OpenAI-compatible, Anthropic and Ollama APIs.

airpost-secrets

The OS keychain, Secret Service, or an AES-256-GCM file.

airpost-ipc

JSON-RPC 2.0 over newline-delimited JSON on a Unix socket.

airpost-client

Discovery, hello, the multi-engine router and typed calls.

airpost-providers

Provider quirks, folder roles and OAuth endpoints.

+ core, net, integrations, wire and activation
§ 08Get Airpost

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. 1
    git clone https://github.com/airpost-mail/airpost.git
  2. 2
    cd airpost && make setup
  3. 3
    make desktop
  4. 4
    make mail
§ 09Questions

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.