skills.rest
oresttokovenko
oresttokovenkoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gws-people

Manage Google contacts, contact groups, and directory profiles via the People API.

Updated Nov 9, 2023
Search Tags:#cli#sync#directory#contacts#gws#contact groups#google people api
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-people-oresttokovenko
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-people
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-people
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-people-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google contacts and directory profiles through the web UI is slow and hard to automate. This Skill exposes the full Google People API through the gws CLI so you can create, update, search, and organize contacts and contact groups directly from the command line. ## Core Features & Use Cases - Contact Management: Create, update, delete, and batch-process contacts, including contact photos, using the people resource methods. - Contact Groups: Create, list, update, and delete contact groups and manage their memberships. - Search & Directory Access: Search personal contacts, other contacts, and domain directory people with sync token support for incremental syncs. - Use Case: A workspace administrator needs to sync the company domain directory into a local CRM. They use gws people listDirectoryPeople with a sync token to pull incremental changes on a schedule. ## Quick Start Ask the AI to list all your Google contact groups using the gws people command after reading the shared gws authentication instructions.

Frequently Asked Questions about gws-people

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Google contacts from the command line?▼

Use gws people searchContacts with a query matching names, nicknames, email addresses, phone numbers, or organizations. Send a warmup request with an empty query first to update the search cache before real searches.

How do I create a contact with the Google People API?▼

Run gws people createContact with the contact fields in the request body. Only one value is allowed for singleton fields like names, birthdays, genders, and biographies, and mutations should be sent sequentially.

What is the difference between contacts and other contacts in Google People API?▼

Contacts are entries explicitly saved in your contact groups, while other contacts are auto-created from interactions. You can copy an other contact into your main contacts with copyOtherContactToMyContactsGroup.

Why does my Google People API sync token expire?▼

Sync tokens expire 7 days after a full sync. An expired token returns an EXPIRED_SYNC_TOKEN error, and the client must issue a new full sync request without a sync_token.

Why does gws people get return a 400 error?▼

The get method returns a 400 error when the personFields parameter is not specified. Always include personFields listing the fields you want, and use people/me for the authenticated user's own profile.

Related Skills

Explore More Software Engineering Skills→
nomad3nomad3

gws-people

Automate Google Contacts and Profiles management via the gws CLI.

Community
Intermediate
cellarwoodcellarwood

recipe-sync-contacts-to-sheet

Export Google Workspace directory contacts to a Google Sheets spreadsheet.

Official
Basic
netanel-abergelnetanel-abergel
5

personal-crm

Sync calendar events and emails to update contacts in a Monday.com-based CRM.

Community
Advanced
AissenLiuAissenLiu

google-workspace

Automate Gmail, Calendar, Drive, Contacts, Sheets, and Docs tasks via Hermes-managed OAuth.

Community
Advanced