gws-people
Google People: Manage contacts and profiles.
Install / Use
npx skills add googleworkspace/cli --skill gws-peopleInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
Our assessment of gws-people
gws-people scores 89/100 on our quality scale, 524th of 1,108 Security skills we index (top 48%).
Its SKILL.md is 6.3 KB long, well organised into 8 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 31,133 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so gws-people is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-26. Automated pattern scan on 2026-09-26. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
gws-people compared with similar skills
All 4 of these similar skills score higher than gws-people; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| gws-people (this skill)by googleworkspace | 89 | 31.1k | 53d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP Server |
Frequently asked questions
- How do I install gws-people?
- Run
npx skills add googleworkspace/cli --skill gws-people. The install tabs above show the steps for each supported agent. - Which AI agents does gws-people work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is gws-people safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is gws-people still maintained?
- The repository was last updated about 2 months ago, so gws-people is actively maintained.
Skill content
View source on GitHubname: gws-people description: "Google People: Manage contacts and profiles." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws people --help"
people (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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
otherContacts
copyOtherContactToMyContactsGroup— Copies an "Other contact" to a new contact in the user's "myContacts" group Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.list— List all "Other contacts", that is contacts that are not in a contact group. "Other contacts" are typically auto created contacts from interactions. Sync tokens expire 7 days after the full sync. A request with an expired sync token will get an error with an google.rpc.ErrorInfo with reason "EXPIRED_SYNC_TOKEN". In the case of such an error clients should make a full sync request without async_token.search— Provides a list of contacts in the authenticated user's other contacts that matches the search query. The query matches on a contact'snames,emailAddresses, andphoneNumbersfields that are from the OTHER_CONTACT source. IMPORTANT: Before searching, clients should send a warmup request with an empty query to update the cache. See https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts
people
batchCreateContacts— Create a batch of new contacts and return the PersonResponses for the newly Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.batchUpdateContacts— Update a batch of contacts and return a map of resource names to PersonResponses for the updated contacts. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.createContact— Create a new contact and return the person resource for that contact. The request returns a 400 error if more than one field is specified on a field that is a singleton for contact sources: * biographies * birthdays * genders * names Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.deleteContactPhoto— Delete a contact's photo. Mutate requests for the same user should be done sequentially to avoid // lock contention.get— Provides information about a person by specifying a resource name. Usepeople/meto indicate the authenticated user. The request returns a 400 error if 'personFields' is not specified.getBatchGet— Provides information about a list of specific people by specifying a list of requested resource names. Usepeople/meto indicate the authenticated user. The request returns a 400 error if 'personFields' is not specified.listDirectoryPeople— Provides a list of domain profiles and domain contacts in the authenticated user's domain directory. When thesync_tokenis specified, resources deleted since the last sync will be returned as a person withPersonMetadata.deletedset to true. When thepage_tokenorsync_tokenis specified, all other request parameters must match the first call. Writes may have a propagation delay of several minutes for sync requests. Incremental syncs are not intended for read-after-write use cases.searchContacts— Provides a list of contacts in the authenticated user's grouped contacts that matches the search query. The query matches on a contact'snames,nickNames,emailAddresses,phoneNumbers, andorganizationsfields that are from the CONTACT source. IMPORTANT: Before searching, clients should send a warmup request with an empty query to update the cache. See https://developers.google.com/people/v1/contacts#search_the_users_contactssearchDirectoryPeople— Provides a list of domain profiles and domain contacts in the authenticated user's domain directory that match the search query.updateContact— Update contact data for an existing contact person. Any non-contact data will not be modified. Any non-contact data in the person to update will be ignored. All fields specified in theupdate_maskwill be replaced. The server returns a 400 error ifperson.metadata.sourcesis not specified for the contact to be updated or if there is no contact source.updateContactPhoto— Update a contact's photo. Mutate requests for the same user should be sent sequentially to avoid increased latency and failures.connections— Operations on the 'connections' resource
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws people --help
# Inspect a method's required params, types, and defaults
gws schema people.<resource>.<method>
Use gws schema output to build your --params and --json flags.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
