Gws Admin Reports

Pulls audit logs and usage reports from Google Workspace Admin SDK, giving you programmatic access to who did what and when in your organization. You can track admin console activities, monitor Drive usage patterns, generate customer usage summaries, and set up real-time notifications for security events. The CLI wraps the reports_v1 API with straightforward commands for each resource type. It's essential for compliance reporting, security monitoring, and understanding how your team actually uses Google Workspace tools. The schema inspection feature helps you build the right queries without constantly referring to Google's API docs.

skills.sh installs: 31.3K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill gws-admin-reports --agent claude-code

Installs into .claude/skills of the current project.

Files

admin-reports (reports_v1)

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

gws admin-reports <resource> <method> [flags]

API Resources

activities

list — Retrieves a list of activities for a specific customer's account and application such as the Admin console application or the Google Drive application. For more information, see the guides for administrator and Google Drive activity reports. For more information about the activity report's parameters, see the activity parameters reference guides.
watch — Start receiving notifications for account activities. For more information, see Receiving Push Notifications.

channels

stop — Stop watching resources through this channel.

customerUsageReports

get — Retrieves a report which is a collection of properties and statistics for a specific customer's account. For more information, see the Customers Usage Report guide. For more information about the customer report's parameters, see the Customers Usage parameters reference guides.