goobook

Allow goobook to access Google contacts using OAuth2

$ goobook authenticate

$ goobook dump_contacts

goobook [OPTIONS] [QUERY]

-h, --help
    Show help message and exit

--version
    Display program version

--addressbook ADDRESSBOOK
    Query specific addressbook (default: all)

--fields FIELDS
    Comma-separated fields to display (default: name,email; use '*' for all)

--global
    Enable tab-completion for all users

--limit LIMIT
    Max results (default: 10)

--name NAME
    Addressbook name (default: Contacts)

--no-rc
    Skip loading .goobookrc config

--print
    Print results instead of clipboard copy

--shell
    Output shell-eval format

Goobook is a command-line utility for querying Google Contacts directly from the shell. It enables fast contact lookups by name, email, or phone, ideal for email clients like mutt, scripting, or tab-completion in terminals.

Setup requires one-time authentication via goobook auth, which opens a browser for OAuth approval and stores credentials in ~/.config/goobook/credentials.json. Queries fetch real-time data from Google's servers, supporting customizable fields (name, email, phone), result limits, and output formats like clipboard copy, shell-eval, or plain print.

Key features include global tab-completion for shell integration and multi-addressbook support. However, due to API changes, functionality is limited post-2021.

Uses deprecated Google Contacts API (v3, shutdown ~2021); no longer works reliably. Requires internet and initial goobook auth. Stores credentials insecurely.

Run goobook auth to authorize Google account.
Config: ~/.config/goobook/config or ~/.goobookrc.

Hook into mutt for alias completion: set alias_query_command="goobook --shell '%s'".

Developed by Jörgen Scheibengruber (tula) in 2010 as Python tool. Last major release ~2017. Abandoned after Google API deprecation.

abook(1), khard(1), mutt(1), vdirsyncer(1)