Skip to content


notmuch is a command-line based program for indexing, searching, reading, and tagging large collections of email messages.


In order to use Notmuch, you will need to have your email messages stored in your local filesystem, one message per file. You can use mbsync to do that.

sudo apt-get install notmuch


To configure Notmuch, just run


This will interactively guide you through the setup process, and save the configuration to ~/.notmuch-config. If you'd like to change the configuration in the future, you can either edit that file directly, or run notmuch setup.

If you plan to use afew set the tags to new.

To test everything works as expected, and create a database that indexes all of your mail run:

notmuch new