Raycast
The mxr Raycast extension puts Now, the five modes and the inbox behind Raycast commands: Now, Inbox, Messages, To Do, Updates, Reading and Archive. Each mode command lists its mode the way the web app does, in the same sections, and acts with that mode’s own verbs. Every row reads in Raycast and also opens in the web app.
It is a client of the daemon, like the web app and the TUI. It reads and acts through the daemon’s local HTTP bridge; nothing is stored in Raycast except its last copy of each list.
What you need
Section titled “What you need”- macOS, Raycast, Node.js 22 or later and npm.
- The mxr daemon running, with its HTTP bridge on (the default). Check with
mxr status.
The extension is private and not in the Raycast Store. Load it from a checkout:
cd apps/raycastnpm cinpm run devnpm run dev imports the commands into Raycast and rebuilds as the code
changes. They stay in Raycast after you stop it.
What each command shows
Section titled “What each command shows”| Command | Sections | Actions |
|---|---|---|
| Now | People, Due Soon, Updates, Reading, Coming Up | Read, Reply, Done Here, Tick Off, Open in mxr |
| Inbox | Every inbox conversation, newest first | Read, Reply, Open in mxr |
| Copy Latest Code | No window | Copies the newest current one-time code |
| Messages | Your Turn, Pinned, Recent, Quiet | Read, Reply, Reply All (groups), Done Here, Filter (⌘F), Open in mxr |
| To Do | Now, each coming week, Whenever, Later | Tick Off, Read Source Email, Open in mxr, Open Source Email in mxr |
| Updates | Needs a Look, Changed, Routine | Copy Code, Read, Done Here, Let Go of This Digest, Open Link, Open in mxr |
| Reading | The edition’s bands, then Later | Read, Read in mxr, Open Original, Save for Later, Let Go |
| Archive | Records | Read Source Email, Open in mxr, Copy Reference |
Shortcuts are Cmd plus the letter the same action has in the TUI and the
web app, so Done Here is ⌘E, Save for Later ⌘B, Mark as Unread ⌘⇧U and Let
Go of This Digest ⌘⇧A. Raycast’s own keys stay where Raycast has one: ⌘Z
undoes, ⌘⇧C copies, ⌘. pins, and Reply All is ⌘⇧R because ⌘A selects the
search text. mxr keys --client web lists the letters. ⌘D shows the reading
pane, which only Raycast has. Every action is also in the ⌘K action panel.
Each row shows who it is from as initials, in a colour picked from them. mxr draws the initials on your Mac, so no sender’s name or address goes to any other service.
Rows also carry what needs your eye: Overdue on a person past your usual reply pace, a ring on a Reading item you have started, and an icon for each kind of Archive record.
Read beside the list
Section titled “Read beside the list”⌘D shows the reading pane in Inbox, Messages, Updates and Reading. It puts the newest message of the selected conversation beside the list, with who it is from, who it went to, when it arrived and which account it is in. Press ⌘D again to hide it. Each command remembers whether its pane is open.
The pane marks nothing read, so you can look through mail and leave it unread. It loads only the selected conversation, and Raycast keeps no copy of it. An Updates line with no email behind it, such as a parcel tracker, shows only its summary.
Rows show when mail arrived: the time today, “Yesterday 14:32”, the weekday within a week, then the date. The tooltip has the full date.
The Inbox loads a page at a time as you scroll.
A list opens with its last copy at once and asks the daemon again underneath, then every 20 seconds while it is open, so mail the daemon has synced shows without reopening the command. The Inbox pauses that once you scroll past its first page, since reloading starts it from the top again.
The daemon keeps ready-made views of what you read recently, so those reads are usually instant. Any change to stored mail, your own actions included, makes the next read build afresh, and a view built while a sync was still writing is replaced as soon as that write finishes, so a list never misses mail the daemon has stored. A view more than a minute old is also built afresh. The daemon renews active views before that expiry. Rebuild time depends on the view and the mailbox. The list shows its last copy meanwhile. See mode-response caching. Reads never count as a Reading visit or mark Updates seen.
Read a conversation
Section titled “Read a conversation”Read (Enter on most rows) opens the conversation in Raycast, newest message first, with who it is from and to and when it arrived. A side panel names the account, the conversation’s labels and folders, and each attachment with its size. Long quoted history and signatures fold the way they do in the web reader. HTML-only mail is shown as text, with images left out, so opening it never loads a sender’s tracking pixel. As in the web app, the conversation is marked read once it has been open a moment; Mark as Unread (⌘⇧U) puts it back. Reply (⌘R), Reply All (⌘⇧R) and Open in mxr (⌘O) work from the reader too.
Copy a one-time code
Section titled “Copy a one-time code”Copy Latest Code syncs all enabled mail accounts and waits for the refresh before looking for a code. If refresh fails or takes too long, it reports that and leaves the clipboard unchanged. It copies the code from your newest sign-in, verification or two-factor email that is still in its window, and says whose it is: “Copied 482913 from Google (accounts.google.com)”. The host is where the mail came from, so a borrowed brand shows. It opens no window, so give it a hotkey in Raycast’s settings and paste straight into the sign-in. The code goes on the clipboard concealed, so Raycast’s clipboard history does not keep it.
mxr finds codes by rules, the same way as mxr code; see
Updates for what counts. An
Updates line with a code shows it and offers Copy Code first, and reading
a sign-in email offers Copy Code while the code still works. Keep mxr up to date so this command can refresh mail before reading codes.
Search and filter by account
Section titled “Search and filter by account”Every command has an account filter in the search bar; press ⌘P to open it.
Each command remembers its choice, and All Accounts is the default. While a
list covers every account, each row carries a coloured tag with the account’s
short name (its key in the config, such as work); the tooltip has the
address.
Typing in a mode command does two things. It narrows that mode’s own rows,
and below them, under All Mail, it lists every conversation in the mailbox
that mxr’s search finds, in the chosen account. In the Inbox command, typing
replaces the inbox with those results. Search runs through the daemon’s
index with the same query language as mxr search, so from:, to:,
subject:, is:unread, has:attachment, after: and quoted phrases all
work; see Search. from: takes a whole address
(from:support@example.com), not part of one; plain words match
sender names.
Every change is previewed
Section titled “Every change is previewed”Done Here, Tick Off, Let Go and Save for Later each ask the daemon for a dry run first and show what it says will change, for example “Would change 1 to-do (ticked off). Nothing changed yet.” Nothing happens until you confirm. Changes the daemon can undo get an Undo button (⌘Z) on the toast that follows. Anything the daemon could not change is listed, in the dialog and on the toast, instead of being reported as done.
Reply opens a form with the recipients and subject filled in and an empty body, as the web composer does. Draft for Me (in the ⌘K action panel) opens a model submenu, then sends the text region in the form, with the exact reply or reply-all intent, to mxr’s writing help. It opens a proof showing additions in bold, removals struck through and unanswered details in inline code. The metadata says which model ran, whether it used your writing history, which voice samples it used, which of your sentences changed and what details remain open. Each Voice example link opens the cited email in the daemon’s web app. The Voice samples count includes only examples that fit the prompt, and reads None when none were used. Your form text stays as written until you accept. Accept replaces only that text region and keeps a signature or forwarded message below it; Retry (⌘R) repeats the same text and action, Try Again with Another Model retries with another catalogue model, Revise with Note applies a note to the shown proof, and Escape keeps your text. Gaps block sending and cannot be overridden. If the form changes while a proof is being prepared, that proof cannot be accepted.
Send Reply runs the same pre-send safety check the daemon enforces on every send:
- A clean reply is handed to the daemon to send ten seconds later, and the toast offers Undo Send. The daemon owns that wait, so closing Raycast does not lose the reply. Its scheduled-send loop runs every minute, so the reply goes out within about a minute. Undo stops it and keeps it in mxr as a draft; once the daemon has started sending, Undo says it is too late.
- Warnings are listed before the reply is scheduled.
- A reply the check would block is only sent if you choose Send Anyway. That send goes immediately, because a scheduled send is checked again when it fires and cannot carry the override, so there is no undo for it.
If you edit the reply while it is being checked, nothing is sent; send again to check what is on screen. Leaving the form without sending throws the draft away. Open in mxr (⌘O) on the form saves what you have written as an mxr draft and opens it in the web composer.
Open in mxr
Section titled “Open in mxr”Open in mxr opens the web app the daemon serves on its bridge port, at the same place: a conversation, a person, a to-do, a Reading item or a mode. The page signs itself in from the daemon on this machine, so the link carries no token.
Settings
Section titled “Settings”The extension reads the bridge port and token from the files the daemon
writes in ~/Library/Application Support/mxr. If your daemon uses another
data directory, set it in the extension’s preferences. If the token file is
missing or out of date, the extension asks the daemon for it the way the web
app does.