google-contacts

Solid

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.

AI & Automation 11 stars 1 forks Updated 2 days ago Apache-2.0

Install

View on GitHub

Quality Score: 82/100

Stars 20%
36
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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...

Details

Author
mishahanin
Repository
mishahanin/heading-os
Created
2 months ago
Last Updated
2 days ago
Language
Python
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category