NAME

       goobook - access your Google contacts from mutt or the command line

SYNOPSIS

       goobook  [ options ] COMMAND

DESCRIPTION

       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

SEE ALSO

       Website: https://pypi.python.org/pypi/goobook/

AUTHOR

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

                                            2020-09-02                                 GOOBOOK(1)