Plug-in for vim to use notmuch
Vim script
Latest commit 468a778 May 23, 2014 @felipec readme: general cleanups
Signed-off-by: Felipe Contreras <>
Failed to load latest commit information.
doc Reorganize files Nov 5, 2013
plugin Improve the way messages are sent Apr 9, 2014
syntax Copy notmuch-vim syntax Apr 3, 2013
Makefile Add vim help Nov 2, 2013
README.asciidoc readme: general cleanups May 23, 2014


notmuch vim

This is a vim plug-in that provides a fully usable mail client interface, utilizing the notmuch framework.


Simply run 'make install'. However, check that you have the depencies below.

vim +ruby

Make sure your vim version has ruby support: check for +ruby in 'vim --version' features.

% vim --version | grep +ruby

ruby bindings

Check if you are able to run the following command cleanly:

% ruby -e "require 'notmuch'"

If you don’t see any errors, it means it’s working and you can go to the next section.

If it’s not, you would need to compile it. An easy way to do that is by downloading notmuch’s source code:

% git clone --branch=0.15.2 git:// ~/notmuch

And then:

% make build notmuch=~/notmuch

(Note: you need to specify the notmuch source directory)

mail gem

Since libnotmuch library concentrates on things other than handling mail, we need a library to do that, and for Ruby the best library for that is called 'mail'. The easiest way to install it is with ruby’s gem. In most distro’s the package is called 'rubygems'.

Once you have gem, run:

% gem install mail

In some systems gems are installed on a per-user basis by default, so make sure you are running as the same user as the one that installed them.

This gem is not mandatory, but it’s extremely recommended.



% gvim -c ':NotMuch'

You might want to write a wrapper script (e.g. vnm)

gvim -c ":NotMuch $*"

So you can run:

vnm is:inbox date:yesterday..

Enjoy ;)

More stuff

As an example to configure a key mapping to add the tag 'to-do' and archive, this is what I use:

let g:notmuch_rb_custom_search_maps = {
	\ 't':		'search_tag("+to-do -inbox")',
	\ }

let g:notmuch_rb_custom_show_maps = {
	\ 't':		'show_tag("+to-do -inbox")',
	\ }