New to Mutt
This guide sets up Mutt Desktop with a personal Gmail account on a Mac without a muttrc. A muttrc is a plain-text file with mail server settings. You do not need Mutt or Neovim installed.
1. Install Mutt Desktop
Download the app from Home. Open the disk image and drag Mutt Desktop into Applications.
2. Create a Google app password
In your Google Account, turn on 2-Step Verification. Then follow Google's App passwords instructions to create one for Mutt Desktop. Use that app password when Mutt Desktop asks. Do not enter your regular Google password.
Google may not offer app passwords for work or school accounts, Advanced Protection, or 2-Step Verification that uses only security keys. This guide covers personal Gmail only. If App passwords is unavailable, you cannot use this setup to read and send mail with Mutt Desktop.
3. Create your muttrc in Terminal
Enter your personal Gmail address, then copy the command into Terminal. It creates ~/.muttrc. If that file already exists, the command stops without changing it.
This page does not save or send your address. It only makes the command.
Enter an address to make the command.
Enter your personal Gmail address above to make the command.
The command creates a private cache folder at ~/.cache/mutt-desktop. The header cache speeds repeat Inbox opens; the message cache speeds reads of messages saved there. help=yes keeps key hints visible. Gmail saves mail sent through its SMTP server, so the command disables a second local Sent copy.
The file contains no password. Personal Gmail has IMAP access enabled; Google lists the IMAP and SMTP servers used here.
4. Open your Inbox and send a message
Open Mutt Desktop. If it finds ~/.muttrc, choose Use This Config; otherwise choose Choose Config File⦠and select it. Enter the Google app password when Mutt Desktop asks for the IMAP password. It asks for the SMTP password when you send, including on later sends.
Use j and k to move through messages, Return to open one, and q to return to the list. Press m to compose or r to reply. In the built-in editor, press Command-Return to review the draft, then y to send. See Help for more keys.