1. Manuals
  2. Tumbleweed
  3. notmuch
  4. notmuch-emacs-mua(1)

Scroll to navigation

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

NAME

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

SYNOPSIS

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

DESCRIPTION

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.

ENVIRONMENT VARIABLES

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

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

SEE ALSO

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

Author

Carl Worth and many others

Copyright

2009-2024, Carl Worth and many others

October 23, 2025 0.38.3