Airpost
An open-source mail client for macOS and Linux, built on a local Rust engine that the desktop app, a CLI, AI agents and a web client all share.
Airpost is a mail client for macOS and Linux. It works with Gmail, Microsoft 365, Outlook.com and any IMAP/SMTP server. There is no Airpost account and no Airpost server in the middle: you install the app, add a mail account, and your mail syncs directly between your computer and your provider.
Underneath the window is airpost-engine, a Rust process that holds your accounts, credentials, the mail database and the search index. The desktop app is one client of that engine. The airpost command, the MCP server for AI agents, the web gateway and service plugins are others, and they all see the same mail, drafts, rules and snoozes.
No release has been published yet. Until the first version is tagged you build Airpost from source. See Install.
Start here
Quickstart
From a fresh build to reading, searching and sending mail.
Install
Release status, platforms, and what each package contains.
One engine, many interfaces
Desktop, CLI, MCP, web and plugins, and when to use which.
How Airpost works
The engine, sync, local features and the security model.
How the pieces fit
The engine is the only process that talks to your mail provider. Everything else speaks JSON-RPC to it over a Unix socket that only your user can reach. The web client never touches the socket directly; it goes through the gateway. The engine can keep running after you quit the desktop app, which is how snoozed threads come back and scheduled mail still goes out on time. The engine explains the details.
What’s in the desktop app
Mail, calendar, contacts
Unified inbox, threads, Gmail labels and IMAP folders. Calendars and contacts over CalDAV and CardDAV, Google contacts through the People API. See Accounts.
Search
from:, to:, subject:, in:, is:, has:attachment, before:/after: with dates like yesterday or 2w, and AND/OR/NOT. Runs against the local index. See Search.
Scheduling
Snooze, send later and send reminders, run by the engine. See Scheduling.
Rules and templates
Mail rules applied as mail arrives, templates and per-address signatures. See Rules and Templates and signatures.
Privacy defaults
Remote images blocked until you load them, known tracking pixels stripped, Gravatar off, warnings when a reply-to address differs from the sender. See Privacy.
Optional AI
Summaries, reply suggestions and inbox sorting with your own OpenAI-compatible or Anthropic key, or a local model through Ollama, LM Studio or llama.cpp. Off until you set it up. See AI features.
You also get one-click unsubscribe, undo send, six bundled themes, a plugin system that still loads Mailspring-era plugins, and integrations for translation (LibreTranslate, DeepL) and grammar checking (LanguageTool) against your own servers or keys.
Beyond the window
The airpost command
Status, search, show, drafts, archive, snooze, rules, unsubscribe, calendar, contacts and a live watch, with --json on everything.
AI agents over MCP
airpost-mcp for Claude Desktop, Claude Code and Codex, with three access levels, hidden accounts and folders, and an audit log.
Web client
airpost-gateway serves a browser client from your own computer or a server. Browsers pair with a one-time code.
Service plugins
Background programs that run next to the engine under launchd or systemd, even while the desktop is closed.
Find your way by goal
| I want to… | Go to |
|---|---|
| Try Airpost on my computer | Quickstart, then Building from source |
| Move over from Mailspring | Accounts (Preferences > Accounts > Import from Mailspring) |
| Script my mail or use it from a terminal | CLI overview and JSON and scripting |
| Let an AI assistant read or draft mail | Agents overview and Access levels |
| Read mail in a browser | Self-hosting overview |
| Keep the engine running without the app | Background services |
| Know where my data lives | Data and files |
| Build a plugin or theme | Plugins, Themes |
Not available yet
Read receipts, link tracking, thread sharing and settings sync between computers need an Airpost server. That server isn’t available yet, and the desktop marks these features as “Needs an Airpost server”.
Where it comes from
Airpost started as a fork of Mailspring. The desktop app is Mailspring’s, modified since; the engine and its libraries are a Rust translation of Mailspring-Sync. Airpost removes the Mailspring ID and subscription features. It is not affiliated with or endorsed by Foundry 376 or the Mailspring project. The source is GPL-3.0 on GitHub.