General
Is FMail3 free?
Yes. FMail3 is offered at no cost as a hobby project for Fastmail users.
Is FMail3 secure?
FMail3 is notarized by Apple and sandboxed, ensuring malware checks and restricted system resource access.
Is FMail3 private?
FMail3 stores no user data and only contacts external servers for version checks via Sparkle.
Is there a quick tour of what FMail3 can do?
Yes. The first time you start FMail3, a short introduction shows its main features and helps you make FMail3 your default email app, start it at login and turn on Spotlight search, each with one click.
Open it again at any time with Help ▸ Show Introduction.
Windows & Tabs
How do I open new windows and tabs?
FMail3 supports multiple windows and tabs. Create new windows via File > New Window (⌘N) or tabs via File > New Tab (⌘T).
Your windows and tabs are saved automatically and come back the next time FMail3 starts, also after restarting your Mac.
Can Fastmail fill the whole window, without a title bar?
Yes. Choose View ▸ Hide Toolbar (⌥⌘T) and Fastmail runs up to the window's top edge, just like Fastmail's own desktop app: the title bar and its title make way for Fastmail's own top bar, with the window buttons on its left.
Drag an empty part of that bar to move the window, or double-click it just like a title bar.
A window without a toolbar has no tabs, since a tab bar would bring the title bar back: File ▸ New Tab is turned off, ⌘W closes the window, and links that would open a tab open in a new window instead. Choose View ▸ Show Toolbar to get tabs back.
What does Hide when losing focus do?
Turn on Hide when losing focus in Settings ▸ User Interface (or click the lock in the toolbar, ⌘L), and FMail3 hides as soon as you switch to another app.
It stays visible while you log in to Fastmail or enter your password, so you can look it up in your password manager.
It also stays visible while Hookmark or Linker is in front, so they can get a link to the selected email. FMail3 hides a few seconds after you leave them.
What do modifier keys do when clicking links?
⌘ + click opens a new tab.
⇧⌘ + click opens a new tab with focus.
⌥⌘ + click opens a new window.
⇧⌥⌘ + click opens a new window with focus.
Email & Notifications
How do I set FMail3 as my default email client?
Open Settings ▸ General and click Set as Default in the Default email app row. FMail3 registers itself directly, no separate utility or manual System Settings steps required.
If it ever fails, a fallback link there points to manual instructions instead.
What mailto: formats are supported?
FMail3 supports mailto: links formatted per RFC 5322, allowing you to open emails directly in FMail3 when it is set as your default email client.
How do notifications work?
FMail3 features a custom desktop notification system that works even without an open email window, connecting directly to Fastmail's JMAP API.
Each notification offers Reply, Mark as Read, Archive, Flag and Delete, and disappears by itself once the email is read or moved, also when you handle it on another device.
With Reply, type your answer right in the notification and click Send. FMail3 sends it from the address the email was sent to, quotes the original below your text, keeps it in the same conversation and marks the original as read.
What is JMAP?
JMAP is Fastmail's open API standard for email management. FMail3 uses it to retrieve unread email counts and other data without requiring an active email window.
Can I use FMail3 with Shortcuts or Siri?
Yes. In the Shortcuts app, search for FMail3 to find Get Unread Mail Count, Search Mail, Open Mailbox, Open Email, New Message and Mark Emails. Combine them into your own shortcuts, or run them from Spotlight.
Some also work with Siri without building a shortcut, for example “How many unread emails in FMail3”, “New message in FMail3” or “Search mail in FMail3”.
FMail3 must be signed in to Fastmail; Shortcuts launches it when needed. Open Mailbox lists top-level mailboxes only.
Can I find my emails with Spotlight?
Yes. Turn on Show emails in Spotlight in Settings ▸ General. FMail3 then adds the subject, sender, recipients and a short preview of your emails from the last 12 months to Spotlight, up to 5,000 per account and for every account you're logged in to. Trash and Junk are left out, and the results stay up to date as mail arrives, moves or is deleted.
Press ⌘Space, search for a subject, sender or recipient, and choose a result to open that email in FMail3.
It's off by default because anyone using your Mac can see these results. Turning it off removes them from Spotlight again.
What is the Attached Files browser?
Tools > Show Attached Files (⇧⌘A) opens a native window listing every attachment across your mailbox, newest first, with thumbnail previews for images and PDFs.
Filter by file type, search by filename or sender, and download, print, or QuickLook-preview any file directly, no need to open the email first.
Use Show Email from a file's menu to jump straight to the email it came from.
Note that not every email shown in the browser will appear selected in Fastmail's mail list once you navigate to it. Spam/Junk and inline images (logos, signature graphics) are automatically excluded.
Can I reply with only part of an email quoted?
Yes. Select the text you want to quote before clicking Reply or Reply All, and FMail3 quotes just that selection instead of the entire message. If nothing is selected, replies work exactly as they do in Fastmail's own web app: the full message is quoted.
Important: in Fastmail Settings ▸ Mail preferences ▸ When replying, Include the original message must be set to As quoted text for this to work.
Can I open a Fastmail link straight into FMail3?
Yes. Copy any Fastmail mail link, then choose Tools ▸ Open Copied FastMail Link (⇧⌘F) to jump right to it.
You can also open a copied Fastmail email link from the Terminal, a shell script, or any automation tool with open -a FMail3 "https://app.fastmail.com/mail/…". FMail3 launches first if it isn't already running, then jumps right to that email.
Claude MCP Server
How to use the MCP Server for Claude
You need a paid subscription for Claude.
When you turn on Enable MCP server in Settings ▸ Claude, you can copy the Python script and run it in the Terminal. This updates your ~/.claude.json file.
We need to do that this way because FMail3 is a sandboxed application, not allowed to write outside its container.
Restart your Claude Code session and verify if the MCP for FMail3 is running by typing /mcp in the Claude Code terminal session. It should say: fmail3 · ✔ connected.
Now you should be able to ask in Claude Code something like "list my Fastmail mailboxes" or "Summarize all emails from today."
What can Claude do with my mail?
Claude can search your mail by text, sender, recipient, subject, date, mailbox, unread, flagged and attachments, read a single email (including recipients and attachment names), list your mailboxes and open an email in FMail3.
It can also mark emails as read, unread, flagged or unflagged, and move emails to another mailbox, for example to Archive. A move replaces all of an email's mailboxes and labels with the destination. Trash, Junk, Drafts and Sent can't be used as a destination.
Claude can never delete or send email through FMail3.
Can I use the MCP server from Claude Code on another computer?
Yes. FMail3 keeps running on your Mac, and Claude Code on another computer (for example a Linux machine on your network) connects to it.
In Settings ▸ Claude, choose the Mac's address in the Also listen on menu: your local network address (such as 192.168.1.10) or your Tailscale address (100.x.x.x). An address that isn't listed can be typed under Other address. An access token is then always required; copy it, or click Regenerate to replace it.
Copy the claude mcp add … command shown below the token and run it on the other computer. It adds FMail3 with the token as an Authorization: Bearer header.
The connection itself isn't encrypted, so only use this on a network you trust, such as your home network or Tailscale.
Is the MCP server safe?
By default the MCP server only accepts connections from your own Mac, and it refuses requests from websites open in your browser, so a web page can't talk to it behind your back.
You can also switch on Require access token for Claude Code on this Mac. FMail3 then adds the token to the setup script for you; run the script again after turning it on or regenerating the token. The token is stored in your Keychain.
Troubleshooting
Why can't I use passkeys or YubiKey?
WKWebView limitations prevent certain features like passkey login or YubiKey support due to strict security constraints in WKWebView, SwiftUI, and Swift 6.
How do I view logs?
FMail3 logs through Apple's unified logging system (no custom log file to manage).
For what's happening right now, open Console.app, select your Mac under Devices, and search for fr.arievanboxel.FMail3.
For older activity, including from previous launches, use Terminal: log show --predicate 'subsystem == "fr.arievanboxel.FMail3"' --info --last 1h. Increase --last 1h to e.g. 24h or 7d to look further back.
macOS retains unified log history for about a week by default.
Why does a tagged email not show its highlight on my other computer?
Text highlights are stored only on the Mac where you created them; that data never leaves your device.
The optional automatic tag sync (Settings ▸ Advanced) is different: it applies a real Fastmail tag (called a Label in Fastmail), which syncs to every device like any other tag.
So if you highlight text on Computer A with auto-tagging enabled, the email will show that tag on Computer B too, but the highlighted text itself will only appear highlighted on Computer A, where it was created.
Can I back up or move my highlights to another Mac?
Yes. Highlights ▸ Export Highlights… (⇧⌘E) saves everything to a portable HTML file, readable on its own, and reloadable with Highlights ▸ Import Highlights… (⇧⌘I) on the same Mac or a new one.
Importing the same file twice is safe; anything already saved is skipped rather than duplicated. Note that files exported before this feature existed can't be re-imported, so re-export them first.