gws-admin-reports

Fetch Google Workspace admin audit logs and usage reports via the gws admin-reports CLI.

8|3|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/haberlah/dotfiles-claude --skill gws-admin-reports-haberlah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-admin-reports
Source: https://github.com/haberlah/dotfiles-claude/tree/main/skills/gws-admin-reports
Command: npx skills add https://github.com/haberlah/dotfiles-claude --skill gws-admin-reports-haberlah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Google Workspace admins need a centralized way to fetch audit logs and usage reports across their domains to monitor security, compliance, and activity trends.

Core Features & Use Cases

  • Retrieve admin activity with activities.list for a customer's apps (e.g., Admin console, Drive).
  • Start real-time monitoring with activities.watch to receive activity notifications.
  • Retrieve usage summaries with customerUsageReports.get to analyze account statistics.
  • Retrieve per-entity and per-user usage with entityUsageReports.get and userUsageReport.get.
  • Discover commands and usage with the gws CLI and the admin-reports resource, including help and parameter schemas.

Quick Start

Run gws admin-reports activities list to fetch the latest activities for a customer.

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 audit logs for my domain?

Retrieve Google Workspace admin audit logs by running the gws admin-reports activities list command via the CLI to fetch the latest activities for a customer's apps like the Admin console or Drive.

Can I monitor Google Workspace usage reports for individual users and entities?

Monitor Google Workspace usage reports for individual users and entities by executing the userUsageReport.get and entityUsageReports.get commands to analyze per-account statistics and activity trends.

How does real-time monitoring work for Google Workspace admin activity?

Real-time monitoring for Google Workspace admin activity uses the activities.watch command on the admin-reports resource to receive continuous activity notifications for your domain's apps.

Do I need specific credentials to fetch Google Workspace usage reports via the CLI?

Fetching Google Workspace usage reports via the gws CLI requires valid credentials and network access to authenticate with the Google Workspace admin SDK and retrieve customer usage data.

What is the best way to analyze overall customer usage statistics in Google Workspace?

Analyze overall customer usage statistics in Google Workspace by running the customerUsageReports.get command, which retrieves comprehensive usage summaries for your entire domain account.