gws-people

Manage Google People API contacts, groups, and directory profiles via gws CLI.

30.3k|1.8k|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/googleworkspace/cli --skill gws-people-googleworkspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-people
Source: https://github.com/googleworkspace/cli/tree/main/skills/gws-people
Command: npx skills add https://github.com/googleworkspace/cli --skill gws-people-googleworkspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the management of Google Contacts and user profiles within your organization, simplifying interactions and data organization.

Core Features & Use Cases

  • Contact Management: Create, update, delete, and retrieve individual contacts and contact groups.
  • Profile Discovery: Search and retrieve information about people within your Google Workspace domain.
  • Use Case: Quickly find and update a colleague's phone number, or list all contacts within a specific group.

Quick Start

Use the gws-people skill to list all contact groups owned by the authenticated user.

Frequently Asked Questions about gws-people

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

FAQPage Schema
How do I manage Google Contacts and directory profiles programmatically?

To manage Google Contacts and directory profiles programmatically, you can use the gws-people skill to interact with the Google People API. It supports creating, updating, deleting, and retrieving contacts and contact groups within your domain.

Do I need the gws CLI tool to search for people in a Google Workspace domain?

Yes, you need the gws CLI tool to search for people in a Google Workspace domain. The gws-people skill requires this command-line tool for execution to query directory profiles and retrieve user information.

Can I create and update Google contact groups using this approach?

Yes, you can create, update, and delete Google contact groups using this approach. The skill manages Google People API resources, allowing full control over both individual contacts and their associated contact groups.

What is the best way to find and update a colleague's phone number in Google Workspace?

The best way to find and update a colleague's phone number in Google Workspace is to use the profile discovery feature to search the directory. Once found, you can update the contact details directly through the same management interface.

How do I list all contact groups owned by an authenticated user?

To list all contact groups owned by an authenticated user, you can use the gws-people skill to retrieve resources from the Google People API. This provides a complete overview of the user's existing contact groups.