Gws People

The gws-people skill enables Google Workspace CLI agents to manage user identities, groups, and directory information within your organization. It provides direct access to the People API for retrieving profiles, updating attributes, and synchronizing data across Google services.

When to use it

• Automating the onboarding process by creating new user accounts and assigning them to specific security groups.
• Bulk updating employee details such as job titles, department assignments, or manager information in bulk.
• Querying directory data to generate reports on team structures or identifying users with specific access permissions.

Key capabilities

• User Management: Create, update, and delete user accounts programmatically.
• Group Administration: Add or remove members from organizational groups and manage group settings.
• Profile Synchronization: Sync changes between local data sources and the Google Workspace directory.
• Directory Search: Query the global address list to find users by email, name, or custom attributes.

Example prompts

• "Create a new user account for '[email protected]' with the first name John and last name Doe."
• "Add all members of the 'Engineering' group to the 'Cloud Platform Admins' security group."
• "Search for all users in the 'Sales' department who have been hired after January 1st, 2024."

Tips & gotchas

Ensure your service account has the necessary People API scopes and permissions granted before attempting to modify directory data. Changes made via this skill may take a few minutes to propagate across all Google Workspace services like Gmail and Drive.