gws-admin-reports

Retrieve and aggregate Google Workspace Admin SDK activity and usage reports via CLI.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/cellarwood/figurio --skill gws-admin-reports-cellarwood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-admin-reports
Source: https://github.com/cellarwood/figurio/tree/main/skills/gws-admin-reports
Command: npx skills add https://github.com/cellarwood/figurio --skill gws-admin-reports-cellarwood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralize and simplify auditing of Google Workspace activity and usage to support security, compliance, and IT governance.

Core Features & Use Cases

  • Audit activity: Retrieve admin activities and events across customers, apps, and devices.
  • Usage reporting: Generate customerUsageReports, entityUsageReports, and userUsageReport to monitor adoption and access patterns.
  • Alerts and workflows: Use channels to watch for specific events and trigger downstream actions.

Quick Start

Fetch the latest admin activity for a given resource and method using the gws-admin-reports CLI.

Frequently Asked Questions about gws-admin-reports

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

FAQPage Schema
How do I retrieve Google Workspace admin activity logs for security auditing?

You can retrieve Google Workspace admin activity logs by specifying the desired resource and method through the CLI's structured parameters, allowing reproducible audit workflows across customers, apps, and devices.

Can I generate usage reports for Google Workspace users and entities?

Yes, you can generate customerUsageReports, entityUsageReports, and userUsageReport to monitor adoption and access patterns, providing centralized usage reporting for IT governance and compliance.

How do I set up alerts for specific Google Workspace admin events?

You can use channels to watch for specific Google Workspace events and trigger downstream actions, enabling automated alerts and workflows based on admin activity and audit log changes.

Does this tool require authentication setup to access Admin SDK reports?

Yes, accessing Admin SDK reports requires proper Google Workspace authentication and admin privileges to retrieve activity logs and usage data, as the CLI operates against live Google Workspace customer resources.

What's the best way to automate Google Workspace audit workflows?

The best way to automate Google Workspace audit workflows is using the CLI's structured parameters for resources, methods, and flags, which enables reproducible scripts for security teams and IT admins.

Are there limitations when monitoring Google Workspace device activity logs?

Google Workspace device activity monitoring is limited to the data exposed by the Admin SDK reports API, covering admin activities and events across customers, apps, and devices within the configured audit scope.