google-contacts

# Google Contacts Search, add, edit, list, get, and delete contacts in Google Contacts. Standalone connector via the Google People API -- NOT connected to the workspace CRM. ## Prerequisites 1. **Install packages:** ```bash pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib python-dotenv ``` 2. **Set up OAuth credentials:** - Go to [Google Cloud Console](https://console.cloud.google.com/apis/credentials) - Create a project (or use existing) - Enable the **People API** (APIs & Services -> Library -> search "People API") - Go to Credentials -> Create Credentials -> OAuth 2.0 Client ID - Application type: **Desktop application** - Download the JSON file - Save as `.sessions/google/credentials.json` 3. **First run:** Any command opens a browser for OAuth consent. Sign in and approve. 2FA is handled by Google's login flow. Token is cached automatically. ## Script Location ``` scripts/google-contacts.py ``` ## Quick Reference | Command | Description | |---------|-------------| | `search "query"` | Prefix search on names, emails, phones (max 30 results) | | `add --name "Name" [--email] [--phone] [--company] [--title] [--notes]` | Create a new contact | | `get people/cXXX` | Get full detail for a single contact | | `edit people/cXXX [--email] [--phone] [--company] [--title] [--notes]` | Update fields on existing contact | | `list [--limit N]` | List contacts sorted by last modified (default: 100) | | `delete people/cX...