Skip to main content

Search your google contacts from mutt.

Project description


The purpose of GooBook is to make it possible to use your Google Contacts in a MUA such as Mutt. It’s use mimics that of abook (somewhat).

Installation Instructions

GooBook is only released as a source distribution.

It can be installed using easy_install or pip or manually with the source tarball.

easy_install or pip

This is the recommended way to install goobook. If installing this way you will not need to download the source manually.

Run easy_install or pip:

$ easy_install -U goobook
$ pip install goobook

easy_install is part of setuptools which should come with most distributions.

Source installation

Download the source tarball, uncompress it, then run the install command:

$ tar -xzvf goobook-*.tar.gz
$ cd goobook-*
$ sudo python ./ install


If you are upgrading from a pre 1.0 version you will have to remove the old cachefile and create a new configuration.


For most users it will be enough to add an entry to your ~/.netrc:

  password secret

To get access too more settings you can create ~/.goobookrc:

# If not given here, email and password is taken from .netrc using
# machine
password: top secret
# The following are optional, defaults are shown
max_results: 9999
cache_filename: ~/.goobook_cache
cache_expiry_hours: 24

Proxy settings

If you use a proxy you need to set the https_proxy environment variable.


To query your contacts:

$ goobook query QUERY

The add command reads a email from STDIN and adds the From address to your Google contacts:

$ goobook add

The cache is updated automatically according to the configuration but you can also force an update:

$ goobook reload

Mutt Setup

Set in your .muttrc file:

set query_command="goobook query '%s'

to query address book. (Normally bound to “Q” key.)

If you want to be able to use <tab> to complete email addresses instead of Ctrl-t add this:

bind editor <Tab> complete-query

To add email addresses (with “a” key normally bound to create-alias command):

macro index,pager a "<pipe-message>goobook add<return>" "add the sender address to Google contacts"

If you want to add an email’s sender to Contacts, press a while it’s selected in the index or pager.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
goobook-1.2.tar.gz (25.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page