Why mxr
mxr keeps a synced mailbox on your computer. Search your history, analyse it with a script, or let your agent work with it. You, your tools and mxr’s own clients all use the same local mailbox.
A connector may be all you need to use Gmail inside your agent. Choose mxr when you also want the synced mailbox on your computer, available to your own tools and to clients you can use yourself.
The daemon handles sync, storage, search and mail operations. The web app, terminal interface, CLI and agent interfaces call it. Build another client without rebuilding the mail engine.
Synced messages and locally cached content can be read from this machine. Initial sync can take time; sync, sending, provider-backed changes, uncached attachments, remote articles, and configured model endpoints may use the network. The demo uses isolated synthetic mail.
After installing mxr, try it with synthetic mail:
mxr demomxr subscriptions --rank --format jsonThe result is a limited candidate set. By default the query returns up to
200 candidates; --rank sorts those results using the current READ flags.
opened_count is the number currently marked READ, not a count of tracked
opens.
Five modes put mail into your day
Section titled “Five modes put mail into your day”On top of that store, mxr treats email as five jobs: conversations with
people, things to do, updates to glance at, reading you chose, and records
to keep. Each job has its own view: Messages, To do, Updates, Reading and Archive.
Now brings together the work that needs you. Inspect placement with
mxr why MESSAGE_ID; Email is five apps at once
explains membership, sorting and personal categories.
Choose mxr when you want:
- synced mail in SQLite on your machine
- Gmail, Outlook and IMAP receive paths, plus Gmail, Outlook or SMTP send paths
- Gmail-style local search over stored mail
- a desk of what needs you, with newsletters and notifications kept off it
- AI features that are off by default, run against a model you choose, and default to a local endpoint
- dry-runnable batch mutations
- structured CLI output for shell scripts and agents
- a TUI, browser UI, and HTTP bridge on the same daemon contract
Check the surfaces in your checkout:
mxr --helpmxr status --format jsonmxr web --print-urlWhat you get: the command surface, daemon health, and active local web URL.
Non-goals
Section titled “Non-goals”mxr is not a hosted connector layer, managed auth service, remote
workflow platform, or backend email API for a server product. It is also
not a standalone desktop app; the GUI surface is the web app, opened with
mxr web or in the thin desktop window around it,
with the modes also in Raycast.
Use something else when:
- You want a hosted connector layer more than a local mail runtime.
- You mainly want a terminal UI and do not care about a broad CLI or daemon.
- You need a production backend email API, not a local user-facing workflow tool.
- You need a hosted MCP endpoint or managed OAuth connector. mxr’s MCP server is local stdio and uses your local daemon.
Provider capability matrix
Section titled “Provider capability matrix”| Adapter | Sync | Send | Labels / folders | Mutations | Notes |
|---|---|---|---|---|---|
| Gmail | yes | yes | labels | yes | Direct Gmail API adapter. |
| IMAP | yes | no | folders | yes | Usually paired with SMTP. |
| SMTP | no | yes | no | no | Send-only adapter. |
| Outlook Personal | yes | yes | folders/categories | yes | Microsoft consumer accounts. |
| Outlook Work | yes | yes | folders/categories | yes | Microsoft 365 work/school accounts. |
| Fake | yes | yes | fixture labels | yes | Tests and mxr demo. |
Verify provider setup:
mxr accounts --format jsonmxr sync --status --format jsonWhat you get: configured accounts and the latest sync state per account.
Interface capability matrix
Section titled “Interface capability matrix”| Interface | Status | Best for | Notes |
|---|---|---|---|
| CLI | available | scripting, batch work, agents | broadest current shell surface |
| TUI | available | daily reading and triage | mailbox-focused interface |
| Daemon socket | available | custom clients | JSON over Unix socket |
| HTTP bridge | available | local web/custom clients | loopback bearer-token bridge |
| Agent skill | available | coding-agent workflows | documents CLI patterns |
| MCP server | available | MCP-native agents | mxr mcp serve, stdio, daemon profile gates |
Start with the demo when you are evaluating fit:
mxr demomxr search "has:attachment" --format jsonmxr reset --hard --dry-runWhat you get: realistic local mail state and safe reset preview without touching your real profile.