gws

Solid

Manage Google Workspace from the CLI: Gmail, Drive, Calendar, Sheets, Docs, Slides, Tasks, Chat, and audit reports via the official `gws` command, with multi-account support through per-account config dirs. Use when the user mentions gmail, drive, calendar, sheets, docs, workspace, gws, email, files, events, or names a configured account alias.

AI & Automation 7 stars 0 forks Updated today MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
30
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# gws Google Workspace operations through the official `gws` CLI. This is the local safety wrapper and workflow guide; use the CLI for execution and load references only for multi-step recipes. ## Multi-Account Model Upstream removed native multi-account support in v0.7.0 (`--account`, `gws auth list`, `GOOGLE_WORKSPACE_CLI_ACCOUNT` no longer exist - do not use them). Accounts are isolated by config directory instead: - Account registry: `~/.config/vd/gws-accounts/<alias>.gws-account.md` - one file per account declaring email, domain, timezone, and its config dir. See `references/account.gws-account.example.md`. - Credentials: one dir per account under `~/.config/vd/gws/<alias>/`, selected via `GOOGLE_WORKSPACE_CLI_CONFIG_DIR`. - The default `~/.config/gws` holds no credentials by design: a bare `gws` call fails with exit code 2 instead of silently using an ambiguous account. Every command is prefixed with the account's config dir: ```bash GOOGLE_WORKSPACE_CLI_CONFIG_DIR="$HOME/.config/vd/gws/<alias>" gws <service> ... ``` ### Account resolution 1. List configured aliases: `ls ~/.config/vd/gws-accounts/` and read the file for the chosen alias. 2. If the user named an account (alias or email), use it. 3. For reads where context makes the account obvious (work domain vs personal), pick it and state which account you used. 4. For writes, or when ambiguous: ask which account, or echo the chosen account and get confirmation. 5. Before any mutating operation, verify the liv...

Details

Author
vanducng
Repository
vanducng/skills
Created
4 months ago
Last Updated
today
Language
HTML
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

gws-workspace

Operate Google Workspace — Gmail, Calendar, Drive, Sheets, Docs, Slides, Chat, Tasks — through the gws CLI (github.com/googleworkspace/cli) with read-by-default safety gates. Use when the user mentions gws, Gmail, email inbox/send/reply/triage, 邮件/收件箱/发邮件/未读邮件, Google Calendar, 日程/日历/创建会议, Google Drive, 谷歌网盘/上传 Drive, Google Sheets, 谷歌表格, Google Docs, 谷歌文档, or asks for Google Workspace automation such as daily/weekly mail+calendar digests (邮件汇总/日程周报). Also use when installing gws, configuring its OAuth client, or troubleshooting gws authentication errors.

1 Updated 2 days ago
laojin1900
AI & Automation Solid

gws

Use the gws CLI for Google Calendar, Gmail, Drive, Sheets, Docs, Tasks, and cross-service Workspace workflows.

132 Updated today
HybridAIOne
Data & Documents Listed

google-workspace

Manage Google Workspace via the `gws` CLI — Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, Tasks, Meet, Slides, Forms, Contacts, and every other Workspace API. Use when: (1) listing, uploading, downloading, or sharing files on Google Drive, (2) reading, sending, labeling, or filtering Gmail messages, (3) creating, updating, or querying Google Calendar events, (4) reading or writing Google Sheets data, (5) creating or editing Google Docs, (6) sending Google Chat messages, (7) managing Google Tasks, (8) any other Google Workspace operation. Wraps the official `gws` CLI which dynamically discovers all Workspace APIs. Outputs structured JSON suitable for agent pipelines.

1 Updated today
geziel16