Skip to content
Get packs

Google Workspace Admin Reports

Lets the agent pull Google Workspace audit logs and admin usage reports via the gws CLI.

Source Download skill
Repository
googleworkspace/cli
Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

This skill teaches an AI agent how to use the gws command-line tool to query Google Workspace admin reporting data. Once installed, the agent can look up audit logs of account activity (such as Admin console and Google Drive events), usage reports for the whole customer account, per-entity usage, and per-user usage, and can set up push notifications for new activity. It also tells the agent to check the gws help and schema output before running a command so the right parameters are used.

Great for

  • Google Workspace administrators who want an assistant to summarise audit or usage data
  • IT or data staff building reports on account activity and tool adoption
  • Developers automating Workspace admin reporting through the gws CLI

Skip it if

  • Users without Google Workspace admin rights, since the reports require administrator access and the skill cannot grant it
  • Anyone expecting it to change settings or act on findings; the file only covers reading reports and managing notification channels, and running it against live tenant data may expose sensitive user activity to the agent's session

Try asking

  • “Show me all Google Drive activity reports for the last 7 days for our domain”
  • “Get the customer usage report for last month and summarise storage and user counts”
  • “Which users used the most Drive storage this week?”
  • “Set up a push notification for Admin console activity and later stop that channel”
Step-by-step guide: how to use Google Workspace Admin ReportsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    gws-admin-reports.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip gws-admin-reports.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip gws-admin-reports.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run 'gws admin-reports --help' and 'gws schema admin-reports.<resource>.<method>' first so the agent uses correct flags.
  • Limit date ranges and filters when querying audit logs to keep results manageable and avoid pulling unnecessary personal data.
  • Install and review the gws-shared skill and its auth setup before use, since this skill depends on it.

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.