Atlas / Skills / googleworkspace / Gws Admin

Gws AdminBLOCK

skills/googleworkspace/gws-admin

Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.

Verdict
BLOCK
Grade
F
Trust score
49 /100
Version
0.22.5
Hosts
3 documented
License
Apache-2.0
Stars
31,721
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

gws

One CLI for all of Google Workspace — built for humans and AI agents. Drive, Gmail, Calendar, and every Workspace API. Zero boilerplate. Structured JSON output. 40+ agent skills included.

[!NOTE] This is not an officially supported Google product.

⬇️ [Download the latest release for your OS](https://github.com/googleworkspace/cli/releases)

gws doesn't ship a static list of commands. It reads Google's own Discovery Service at runtime and builds its entire command surface dynamically. When Google Workspace adds an API endpoint or method, gws picks it up automatically.

[!IMPORTANT] This project is under active development. Expect breaking changes as we march toward v1.0.

Contents

  • Prerequisites
  • Installation
  • Quick Start
  • Why gws?
  • Authentication
  • AI Agent Skills
  • Advanced Usage
  • Environment Variables
  • Exit Codes
  • Architecture
  • Troubleshooting
  • Development

Prerequisites

  • Node.js 18+ — for npm install (or download a pre-built binary from [GitHub Release
Read from source at commit bcdfbd3e9abfOBSERVED · 2026-10-20
Advertisement
02

Install

Commands as the repository documents them. They are shown, not run.

npm install -g @googleworkspace/cli
npx skills add https://github.com/googleworkspace/cli
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail
npm i -g @googleworkspace/cli
npm i -g @googleworkspace/cli
03

Host compatibility

What the documentation claims. We have not run a compatibility test.

HostStatusNotes
claude-desktopmentioned
gemini-climentioned
openclawmentioned
04

What it tells the agent

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: gws-admin-reports
description: "Google Workspace Admin SDK: Audit logs and usage reports."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws admin-reports --help"
---

# 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.

```bash
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:

```bash
# 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.
05

Trust audit

BLOCKgrade F · trust 49/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeFAIL
L2Instruction surface (what it tells the agent)FAIL
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (5 observation(s))
Network
declared (1 observation(s))
Shell
declared (4 observation(s))
Dependencies
not all pinned
Secrets in source
found

Findings (17)

CRITICALHard-coded secrets · secret.private_key · CWE-798, CWE-321
crates/google-workspace-cli/src/auth.rs:581
"private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvwIBADANBgkqhkiG9w0BAQEFAASC\n-----END PRIVATE KEY-----\n",
CRITICALHard-coded secrets · secret.private_key · CWE-798, CWE-321
crates/google-workspace-cli/src/auth.rs:681
"private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvwIBADANBgkqhkiG9w0BAQEFAASC\n-----END PRIVATE KEY-----\n",
CRITICALPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
skills/gws-people/SKILL.md:37
- `list` — List all "Other contacts", that is contacts that are not in a contact group. "Other contacts" are typically auto created contacts from interactions. Sync tokens expire 7 days after the full
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
HIGHPrompt injection · prompt.override · CWE-94, CWE-1427
skills/gws-modelarmor-create-template/SKILL.md:33
| `--preset` | — | — | Use a preset template: jailbreak |
Why it matters. asks the agent to drop prior instructions or safety
Fix. remove the instruction
HIGHPrompt injection · prompt.override · CWE-94, CWE-1427
skills/gws-modelarmor-create-template/SKILL.md:39
gws modelarmor +create-template --project P --location us-central1 --template-id my-tmpl --preset jailbreak
Why it matters. asks the agent to drop prior instructions or safety
Fix. remove the instruction
HIGHPrompt injection · prompt.override · CWE-94, CWE-1427
skills/gws-modelarmor-create-template/SKILL.md:45
- Defaults to the jailbreak preset if neither --preset nor --json is given.
Why it matters. asks the agent to drop prior instructions or safety
Fix. remove the instruction
LOWInformation disclosure · disclose.log_secret · CWE-209, CWE-532
.github/workflows/automation.yml:138
console.log(`Token cannot add labels for this review event (${e.message}) — skipping`);
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
crates/google-workspace-cli/src/executor.rs:1817
params.insert("name".to_string(), json!("projects/../../etc/passwd"));
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
crates/google-workspace-cli/src/helpers/events/subscribe.rs:702
let matches = make_matches_subscribe(&["test", "--output-dir", "../../etc"]);
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
crates/google-workspace-cli/src/helpers/gmail/watch.rs:803
let matches = make_matches_watch(&["test", "--output-dir", "../../etc"]);
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
crates/google-workspace-cli/src/helpers/gmail/watch.rs:812
let matches = make_matches_watch(&["test", "--subscription", "../../evil"]);
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
crates/google-workspace-cli/src/helpers/modelarmor.rs:433
Ok(include_str!("../../templates/modelarmor/jailbreak.json").to_string())
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@changesets/cli, lefthook
Why it matters. 2 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
README.md:432
**Fix:** Open the [OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent) in your GCP project → **Test users** → **Add users** → enter your Google account email. Then retry `
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
INFOPrompt injection · prompt.authority_framing · CWE-94, CWE-1427
CHANGELOG.md:543
Workspace admins can still select these scopes manually via the "Full Access"
INFOPrompt injection · prompt.credential_read · CWE-94, CWE-1427
AGENTS.md:200
| `GOOGLE_WORKSPACE_CLI_TOKEN` | Pre-obtained OAuth2 access token (highest priority; bypasses all credential file loading) |
Why it matters. asks the agent to read credentials
INFOPrompt injection · prompt.credential_read · CWE-94, CWE-1427
CHANGELOG.md:40
Closes #623. The CLI no longer writes a fallback `.encryption_key` text file on macOS and Windows when securely storing credentials. Instead, it strictly uses the native OS keychain (Keychain Access o
Why it matters. asks the agent to read credentials

Gates applied: critical_finding, instruction_override, no_behavioural_pass, undeclared_transfer.

Audited 2026-10-20 · audit v0.4.1 · source sha bcdfbd3e9abffull audit observations/trust-audit/skill/googleworkspace__gws-admin.json · Report an issue / request a re-scan
06

Audit history

Every audit this skill has had.

DateSourceVerdictGradeScoreChange
2026-10-20bcdfbd3e9abfBLOCKF49first audit
07

Questions

What does the gws-admin — googleworkspace/cli skill do?

Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.

Is gws-admin — googleworkspace/cli safe to install?

No — not without reading the findings first. The audit graded it F (49/100) and found 6 critical or high issues in the source. Each one is listed on this page with the file and line it is on.

What can gws-admin — googleworkspace/cli access on my machine?

The audit observed that it reaches the network, runs shell commands and reads or writes files. Each of those is consistent with what it says it does. Secrets in the source: found — see the findings.

Which assistants does gws-admin — googleworkspace/cli work with?

Its documentation mentions claude-desktop, gemini-cli and openclaw. That is what the text claims, not a compatibility test we ran.

How current is this page?

The grade is for one exact copy of the source (bcdfbd3e9abf), read on 2026-10-20. The repository is watched, and a new audit runs when it changes — this is the first audit.

Add this badge to your README

Shows this page's audit result and links back to it. It updates when the audit does.

ModelsAtlas audit badge

Markdown
[![ModelsAtlas audit: Gws Admin](https://modelsatlas.com/skills/googleworkspace/gws-admin/badge.svg)](https://modelsatlas.com/skills/googleworkspace/gws-admin/)

Not your listing, or something out of date? Claim or update your listing.

Advertisement