gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
What it does
This tool helps Google Workspace administrators get reports on activities and usage within the company's account. It can list specific activities or provide usage summaries by customer, entity, or user.
When to use it
- ✓Check who accessed what in Google Drive.
- ✓Get a summary of app usage by all users.
- ✓Monitor administrative activities in the account.
Example of what to ask your AI
“What were the login activities in the Admin Console last week?”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You specify the type of report you want (activities, usage by customer, entity, or user), and the tool queries Google Workspace data to show you the information.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-admin-reportsOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-admin-reports/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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.
FAQ
How do I know which reports are available?
You can use the '--help' command to see all the report and activity options the tool can fetch.
Do I need any special permissions?
Yes, you need to have administrator privileges in Google Workspace to use this tool.
Can I receive notifications about new activities?
Yes, the tool allows you to set up notifications to be alerted when certain activities occur.
Details
Original description by the author
Google Workspace Admin SDK: Audit logs and usage reports.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6250
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
gws-chat-send
Helps your agent send messages to a space in Google Chat. It's useful for communicating with teams.
googleworkspace/cli
Similar skills
data-throughput-accelerator
Makes your agent speed up the movement of large data volumes. It finds bottlenecks and ensures data is transferred quickly and correctly.
affaan-m/ECC
inventory-demand-planning
Helps your agent predict product demand in stores. It optimizes stock and plans when to run promotions to sell more.
affaan-m/ECC
market-research
Helps your agent conduct market research and competitive analysis. Provides summaries with source attribution.
affaan-m/ECC