goobook(1)

goobook1

Access your google contacts from mutt or the command line

Usage

goobook [options] COMMAND

Overview

goobook can be used to access your Google contacts from the command line. It can also be easily integrated into MUAs such as mutt. It can be used from mutt the same way as abook.

Options

-h, --help

show the help message and exit

-c FILE, --config FILE

specify alternative configuration file

-v, --verbose

be verbose about what is going on (stderr)

-V, --version

print version and exit

-d, --debug

output debug information to stderr

Command

authenticate

Allow goobook to access your Google contacts using OAuth2.

add [NAME] [EMAIL] [PHONE]

Add a new Google contact. If NAME and EMAIL is not specified, read an email address from stdin and add the From: address to your Google contacts.

config-template

Display a config template of that can be written to ~/.config/goobookrc.

dump_contacts

dump all your contacts to XML (stdout).

dump_groups

dump your contact groups to XML (stdout).

dquery QUERY_STRING

Search contacts for QUERY_STRING, nice vcard like output. QUERY_STRING is a Python flavoured regexp where all ' ' is replaced with .*.

query [-s|--simple] QUERY_STRING

Search contacts for QUERY_STRING, mutt compatible plain text output. --simple output format was requested for use with notmuchmail. QUERY_STRING is a Python flavoured regexp where all ' ' is replaced with .*.

reload

Reload contacts from Google and update cache.

Configuration

For most users it will be enough to run:
goobook authenticate --help
and follow the instructions
To have access to more advanced options, you can generate a config file by doing:
goobook config-template > ~/.config/goobookrc

An example config can look like this:

[DEFAULT]
cache_expiry_hours: 24

Releases

4 releases since Debian 9 (Stretch); the text changed 3 times.

  1. 9
  2. 10
  3. 11
  4. 12

--config until Debian 9 (Stretch); -c until Debian 9 (Stretch).

Author

This manual page has been written by Dariusz Dwornikowski and Christer Sjöholm

From goobook 3.5.2-1 in Debian 12 (Bookworm). Parsed by carta from the page's man source.