NOTMUCH-EMACS-MUA(1) notmuch NOTMUCH-EMACS-MUA(1)

notmuch-emacs-mua - send mail with notmuch and emacs

notmuch emacs-mua [options ...] [<to-address> ... | <mailto-url>]

Start composing an email in the Notmuch Emacs UI with the specified subject, recipients, and message body, or mailto: URL.

Supported options for emacs-mua include

Display help.
Specify the subject of the message.
Specify a recipient (To).
Specify a carbon-copy (Cc) recipient.
Specify a blind-carbon-copy (Bcc) recipient.
Specify a file to include into the body of the message.
Go to the Notmuch hello screen instead of the message composition window if no message composition parameters are given.
Even if a window system is available, use the current terminal.
Use emacsclient(1) https://manpages.debian.org/emacsclient.1.html, rather than emacs(1) https://manpages.debian.org/emacs.1.html. For emacsclient(1) https://manpages.debian.org/emacsclient.1.html to work, you need an already running Emacs with a server, or use --auto-daemon.
Automatically start Emacs in daemon mode, if the Emacs server is not running. Applicable with --client. Implies --create-frame.
Create a new frame instead of trying to use the current Emacs frame. Applicable with --client. This will be required when Emacs is running (or automatically started with --auto-daemon) in daemon mode.
Output the resulting elisp to stdout instead of evaluating it.

The supported positional parameters and short options are a compatible subset of the mutt(1) https://manpages.debian.org/mutt.1.html MUA command-line options. The options and positional parameters modifying the message can't be combined with the mailto: URL.

Options may be specified multiple times.

Name of emacs command to invoke. Defaults to "emacs".
Name of emacsclient command to invoke. Defaults to "emacsclient".

notmuch <#notmuch-1>, emacsclient(1) https://manpages.debian.org/emacsclient.1.html, mutt(1) https://manpages.debian.org/mutt.1.html

Carl Worth and many others

2009-2026, Carl Worth and many others

April 17, 2026 0.40