goobook

Google Contacts command-line interface

TLDR

Complete OAuth2 setup so goobook can read Google Contacts

$ goobook authenticate

Export all contacts as XML on stdout

$ goobook dump_contacts

goobook provides command-line access to Google Contacts, designed primarily for integration with the mutt email client. It allows searching contacts for email address completion and adding new contacts from email headers.For mutt integration, add to .muttrc:

$ set query_command="goobook query %s"

Configuration is stored in ~/.goobookrc and includes Google API credentials obtained through the OAuth2 authentication flow.

PARAMETERS

authenticate

Authenticate with Google and store OAuth2 credentials

query QUERY

Search contacts matching query

add

Add contact from email headers (stdin)

dump_contacts

Export all contacts to XML format

reload

Reload and cache contacts from Google

CONFIGURATION

~/.goobookrc

Configuration file containing Google API credentials, OAuth2 tokens, and cache settings.

INSTALL

sudo apk add goobook

nix profile install nixpkgs#goobook

CAVEATS

Requires Google API credentials and OAuth2 authentication. Google's API quotas may limit frequent queries. Contact changes may take time to sync. The Google Contacts API access requires proper OAuth scopes.

HISTORY

goobook was created to bridge the gap between command-line email clients like mutt and Google's contact management. It provides a simple interface to Google Contacts that works well with Unix text-processing tools and email workflows.