gws-admin-reports Skill for Claude Code: Workspace Audit Logs and Usage Reports

Gives your assistant the gws command for Google Workspace audit logs and usage reports from the Admin SDK Reports API.

Installs: 31K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

This is the gws command reference for the Admin SDK Reports API, from the googleworkspace/cli repo. It tells the agent how to call gws admin-reports for activity logs, customer usage, entity usage and user usage reports.

It does not list steps or examples. The agent is told to run gws schema to see each method's parameters, and to read gws-shared for sign-in and safety rules, so install that too.

Good for

Workspace admins who review audit logs and usage reports
IT and security teams who want an assistant to run the report commands
People whose AI assistant can already run terminal commands and who use the gws command line

Install gws-admin-reports

Claude Code

Copy this prompt.

Install the gws-admin-reports skill in Claude Code. Run this command:

npx skills add https://github.com/googleworkspace/cli --skill gws-admin-reports --skill gws-shared

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

This installs 2 skills: gws-admin-reports and gws-shared, which the skill tells the agent to read for sign-in and safety rules. The skill only wraps the gws program, so install gws first and sign in once with gws auth login. The README says an unverified Google app limits consent to about 25 scopes, so choose only the services you need when you sign in.

From the vendor's docs. Source.

What's in the skill

When it loads

Google Workspace Admin SDK: Audit logs and usage reports.

Sections in SKILL.md

API Resources
activities
channels
customerUsageReports
entityUsageReports
userUsageReport
Discovering Commands

Key facts

Author: googleworkspace (GitHub organization)
License: Apache-2.0
Installs on skills.sh: 30,958 (Nov 2, 2026)
GitHub stars: 32,038 for the whole repo (Nov 2, 2026)
Status: Not an officially supported Google product
What installs: 1 file (SKILL.md). It tells the agent to read gws-shared first.
Needs: The gws program on your PATH, plus a Google sign-in
Last commit: Oct 30, 2026 (repo)

What it includes

Lists account activities for an application such as Admin console or Drive
Retrieves activities for a customer's account and an application, for example the Admin console or Google Drive.
Try: “List recent Drive activity from the admin audit log.”
Network · activities list
Starts notifications for account activities
Starts receiving push notifications for account activities.
Write · activities watch
Stops watching through a notification channel
Stops the notifications you started with the watch method.
Write · channels stop
Gets a usage report for the whole account
Retrieves a report of properties and statistics for a specific customer's account.
Try: “Get the customer usage report for yesterday.”
Network · customerUsageReports get
Gets usage by entities that users work with
Retrieves a report of properties and statistics for entities used by users within the account.
Network · entityUsageReports get
Gets usage statistics for a set of users
Retrieves a report of properties and statistics for a set of users in the account.
Try: “Get the user usage report for one user.”
Network · userUsageReport get
Shows a method's required parameters, types and defaults
The skill tells the agent to inspect a method with gws schema before calling it, then build the --params and --json flags from the result.
Read · gws schema admin-reports.<resource>.<method>

From the official docs

Permissions

Medium risk

The assistant can read audit logs and usage reports for your Google Workspace account. Keep that data inside what your organization allows you to share.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It reads audit logs and usage data about your account
The activities and usage reports cover what users did and how they used Workspace. Share them with the assistant only if your organization allows it. github.com
It can start push notifications for account activity
The activities watch method starts notifications, and the channels stop method ends them. Stop any channel you no longer need. github.com
Needs the gws program and a Google sign-in first
The skill only wraps the gws command line. Install gws and run its sign-in before the first use, as the README describes. github.com

Technical details

Turning on read-only	The skill has no read-only switch. gws-shared tells the agent to confirm write and delete commands with you and to prefer --dry-run for destructive operations. You can also sign in with only the services you need.
Talks to	Google Workspace APIs, through the gws program
Sign-in and keys	gws keeps your Google sign-in encrypted on your machine, with the key in your operating system keyring, per the README.

Questions

What does gws-admin-reports do?

It teaches the assistant the gws admin-reports command, which reads Google Workspace audit activities and usage reports. It lists resources and methods but no step-by-step recipes.

How do I install it?

Use the install box above. It installs this skill and gws-shared, which the skill tells the agent to read. The gws program is a separate install, and you sign in to Google once.

Do I need to be a Workspace admin?

The skill does not say. It describes reports for a customer's account, and the README asks for a Google account with access to Google Workspace. Whether you can read these reports depends on your Google permissions.

Do I need an API key?

No key is named in the skill. You need the gws program and a Google account with access to Google Workspace. The README says gws needs a Google Cloud project for OAuth sign-in credentials. gws auth setup creates one but requires the gcloud CLI, so without gcloud you set up OAuth by hand in the Cloud Console.

Does it work in the Claude app or ChatGPT?

The repo documents no route for them. The commands are gws shell commands, so you need an assistant that can run commands on your computer, such as a coding agent.

How is it different from the other gws skills?

It lists API resources only. gws-calendar and gws-drive each open with a table of helper commands such as gws calendar +agenda and gws drive +upload; this skill has none, just the resources activities, channels, customerUsageReports, entityUsageReports and userUsageReport. It also holds no step-by-step recipes like the recipe-* skills. The agent is told to run gws schema admin-reports.<resource>.<method> to build parameters.

Is it safe?

Most methods read reports and logs. The watch and stop methods start and end notifications, so approve those. The data covers your whole account, so share it with the assistant only if your policy allows it.

Is this an official Google skill?

No. The README says gws is not an officially supported Google product, although the repo sits under the googleworkspace GitHub organization.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-admin-reports

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 8

googleworkspace/cli README · github.com
gws-admin-reports SKILL.md · github.com
skills CLI commands · github.com
googleworkspace/cli LICENSE · github.com
gws-admin-reports on skills.sh · skills.sh
gws-calendar SKILL.md · github.com
gws-drive SKILL.md · github.com
gws-shared SKILL.md · github.com