goobook
Google Contacts command-line interface
TLDR
Allow goobook to access Google contacts using OAuth2
SYNOPSIS
goobook command [arguments]
DESCRIPTION
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:
PARAMETERS
authenticate
Authenticate with Google and store OAuth2 credentialsquery QUERY
Search contacts matching queryadd
Add contact from email headers (stdin)dump_contacts
Export all contacts to XML formatreload
Reload and cache contacts from Google
CONFIGURATION
~/.goobookrc
Configuration file containing Google API credentials, OAuth2 tokens, and cache settings.
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.
