How to set up mutt (text-based mail client) with Gmail?

A step-by-step guide to configure your terminal mail client!

What, When and Why?

Photo by Michael Dziedzic on Unsplash

The Steps (For Ubuntu 18.04 and above)

sudo apt-get install mutt
mkdir -p ~/.mutt/cache/headers
mkdir ~/.mutt/cache/bodies
touch ~/.mutt/certificates
touch ~/.mutt/muttrc
# ================  IMAP ====================
set imap_user =
set imap_pass = yourpassword
set spoolfile = imaps://
set folder = imaps://
set record="imaps://[Gmail]/Sent Mail"
set postponed="imaps://[Gmail]/Drafts"
set mbox="imaps://[Gmail]/All Mail"
set header_cache = "~/.mutt/cache/headers"
set message_cachedir = "~/.mutt/cache/bodies"
set certificate_file = "~/.mutt/certificates"
# ================ SMTP ====================
set smtp_url = "smtp://"
set smtp_pass = $imap_pass
set ssl_force_tls = yes # Require encrypted connection
# ================ Composition ====================
set editor = "vim" # Set your favourite editor.
set edit_headers = yes # See the headers when editing
set charset = UTF-8 # value of $LANG; also fallback for send_charset
# Sender, email address, and sign-off line must match
unset use_domain # because joe@localhost is just embarrassing
set realname = "Your Name"
set from = ""
set use_from = yes
Allow less secure apps: ON
mutt (Pic source:

Getting Started with mutt

Recall postponed message? ([yes]/no):

SWE Intern’21@HackerRank | GSoC’21 @CNCF:Buildpacks | CNCF Spring Intern’21 for CNCF: Kubernetes| GSoC ’20@RTEMS | Learner | Poet.