gws-people

Installation
Summary

Google Contacts and profiles management via the People API.

  • Manage contact groups with create, update, delete, and batch operations; contact group names must be unique per user
  • Create, update, and batch-manage individual contacts with support for photos, metadata, and field-level control via update_mask
  • Search contacts across grouped contacts, other contacts, and domain directory with warmup request requirement for cache optimization
  • List and sync contacts incrementally using sync tokens (7-day expiration) and page tokens; domain directory listing includes deleted contact tracking
  • Requires gws binary and Google Workspace authentication; use gws schema to inspect method parameters before execution
SKILL.md

people (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws people <resource> <method> [flags]

API Resources

contactGroups

  • batchGet — Get a list of contact groups owned by the authenticated user by specifying a list of contact group resource names.
  • create — Create a new contact group owned by the authenticated user. Created contact group names must be unique to the users contact groups. Attempting to create a group with a duplicate name will return a HTTP 409 error. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.
  • delete — Delete an existing contact group owned by the authenticated user by specifying a contact group resource name. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.
  • get — Get a specific contact group owned by the authenticated user by specifying a contact group resource name.
  • list — List all contact groups owned by the authenticated user. Members of the contact groups are not populated.
  • update — Update the name of an existing contact group owned by the authenticated user. Updated contact group names must be unique to the users contact groups. Attempting to create a group with a duplicate name will return a HTTP 409 error. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.
  • members — Operations on the 'members' resource
Related skills
Installs
13.2K
GitHub Stars
26.1K
First Seen
Mar 4, 2026