google-contactslisted

Search, add, edit, and manage contacts in Google Contacts via the People API. Use for any task involving looking up contact details, adding new contacts to Google, updating phone numbers or emails, or browsing the contact list. Trigger when the user says "google contacts", "look up contact", "add to contacts", "add to google contacts", "find their number", "update their email", "search contacts for", or any reference to managing contacts in Google. This is a STANDALONE connector -- completely separate from the workspace CRM system. Do NOT trigger for CRM operations (use /crm for that). Do NOT trigger for Exchange/Outlook contacts.
mishahanin/heading-os · ★ 11 · AI & Automation · score 78

Install: claude install-skill mishahanin/heading-os

# 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