googleworkspace/cli · Official

gws-admin-reports

Google Workspace Admin SDK: Audit logs and usage reports.

All-time #814 Trending #1636 Hot #437 First seen Mar 4, 2026
8-week activity · all time api

Installation

$ npx skills add googleworkspace/cli --skill gws-admin-reports

Summary

  • Query Google Workspace audit logs, activity feeds, and usage reports across customers and users.
  • Access five resource types: activities (with list and watch for push notifications), channels, customer usage reports, entity usage reports, and user usage reports Retrieve audit logs for specific applications, customer account statistics, and per-user activity and usage metrics Requires Google Workspace Admin SDK authentication; see shared gws documentation for auth setup and security rules Use gws schema to inspect required parameters and data types before constructing API calls

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Apr 1, 2026

This skill provides instructions for using the 'gws' CLI tool to interact with the Google Workspace Admin SDK to retrieve audit logs and usage reports.

snyk LOW

Analyzed Apr 1, 2026

No issues detected.

socket Score 0.9000 · 0 alerts

Analyzed Apr 1, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli

Browse all from googleworkspace/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 30.8K
License LICENSE
Default branch main
Open issues 129
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws admin-reports --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,356 B
  • docs SUMMARY.md 82 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 27,627 installs

SKILL.md

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.

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.