Gws Admin Reports
- 24.6k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
gws-admin-reports is a Google Workspace CLI skill providing access to audit logs, activity reports, and usage metrics via the Admin SDK.
About
This skill provides access to Google Workspace Admin SDK reporting APIs for auditing and analytics. It retrieves activity logs, customer usage statistics, entity usage reports, and user-level metrics. Developers use it to build administrative dashboards, compliance reports, and usage analytics for Workspace deployments.
- Retrieves audit logs and activity reports from Google Workspace
- Generates usage reports for customers, entities, and individual users
- Watches resource changes via push notifications
Gws Admin Reports by the numbers
- 24,574 all-time installs (skills.sh)
- +816 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #39 of 690 Office & Documents skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
npx skills add https://github.com/googleworkspace/cli --skill gws-admin-reportsAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 24.6k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
How do you pull Google Workspace audit logs from the CLI?
Access Google Workspace audit logs and usage reports for administrative oversight.
Who is it for?
Developers or platform engineers automating Google Workspace compliance checks, security reviews, or usage reporting from the terminal.
Skip if: Developers without Google Workspace super-admin credentials or those who only need end-user Calendar or Gmail actions rather than tenant-wide audit data.
When should I use this skill?
A developer asks to list Workspace admin activities, audit logs, or usage reports via gws or the Admin Reports API.
What you get
Structured Admin SDK activity and usage report records returned as CLI table or JSON output.
- audit activity listings
- usage report JSON or table output
By the numbers
- Supports 5 main API resources: activities, channels, customerUsageReports, entityUsageReports, userUsageReport
Files
admin-reports (reports_v1)
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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.
entityUsageReports
get— Retrieves a report which is a collection of properties and statistics for entities used by users within the account. For more information, see the Entities Usage Report guide. For more information about the entities report's parameters, see the Entities Usage parameters reference guides.
userUsageReport
get— Retrieves a report which is a collection of properties and statistics for a set of users with the account. For more information, see the User Usage Report guide. For more information about the user report's parameters, see the Users Usage parameters reference guides.
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws admin-reports --help
# Inspect a method's required params, types, and defaults
gws schema admin-reports.<resource>.<method>Use gws schema output to build your --params and --json flags.
Related skills
Lark DocGenerate, update, and maintain structured documentation directly inside Lark/Feishu using natural language and agentic workflows.475kLark DriveLet their coding agents read, create, update and search documents stored in Lark (Feishu) Drive directly from prompts.475kLark SheetsConnect Claude, Cursor or other agents directly to Feishu/Lark spreadsheets for live data reads, writes, and structured automation.474kLark WikiGenerate, update, and sync structured knowledge bases inside Lark (Feishu) directly from code, specs, or agent output.474kLark WhiteboardGenerate, edit, and collaborate on visual diagrams and flowcharts directly inside Claude, Cursor or other agents.474kLark SlidesInstantly generate polished, professional slide decks from specs, roadmaps, or meeting notes using Lark/Feishu.474kForks & variants (1)
Gws Admin Reports has 1 known copy in the catalog totaling 6 installs. They canonicalize to this original listing.
- jetbrains - 6 installs
How it compares
Choose gws-admin-reports over generic Gmail or Calendar gws skills when the task requires tenant-wide audit or usage data from the Admin SDK rather than individual user mailbox or event operations.
FAQ
What CLI command does gws-admin-reports use?
gws-admin-reports runs gws admin-reports with a resource and method, for example gws admin-reports activities list, following the Admin Reports API reports_v1 surface documented in the skill.
What do you need before running gws-admin-reports?
gws-admin-reports requires the gws binary installed, gws-shared/SKILL.md loaded for authentication and security rules, and Google Workspace admin credentials with access to Admin SDK reports.
Is Gws Admin Reports safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.