Agent skill

Google Workspace

by espennilsen in espennilsen/pi

Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows.

MITAuto-check passedDocuments & Office

Install Google Workspace

skills CLI
$ npx skills add espennilsen/pi --skill google-workspace -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install espennilsen/pi google-workspace --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-workspace .claude/skills/google-workspace && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-workspace
GitHub stars
122
Token cost
~3.4k tokens
SKILL.md length
786 words
Files
78 (incl. references)
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows.

  • Asked to send email
  • SKILL.md covers Installation & Auth, CLI Syntax, Shell Tips and Security Rules, plus 6 more sections
  • Needs GOOGLE_APPLICATION_CREDENTIALS
  • Read/write spreadsheets

What it does

Google Workspace is an agent skill from espennilsen/pi. Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows. Use when asked to send email, read/write spreadsheets, upload files to Drive, manage contacts, create presentations, send Chat messages, create docs, or any Google Workspace operation. Also triggers on "gws", "Google Drive", "Google Sheets", "Gmail", "Google Docs", "Google Slides", "Google Chat", "Google Meet", "Google Forms", "check my inbox", "upload to Drive", "read…

Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 78 other files, including reference files (for example `references/gws-admin-reports.md`, `references/gws-chat-send.md` and `references/gws-chat.md`).

It sits in Documents & Office, covering Cloud office suites, Excel spreadsheets and Email management. It works with Google Workspace, Gmail, Google Docs and Google Sheets. The licence is MIT.

When your agent uses it

  • Asked to send email
  • Read/write spreadsheets
  • Upload files to Drive
  • Manage contacts

Example prompts

  • “Google Drive”
  • “Google Sheets”
  • “Google Docs”
  • “/google-workspace”

What it can do on your machine

Read from SKILL.md and the folder at commit 79d019b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOGLE_APPLICATION_CREDENTIALS

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Workspace loads about 3.4k tokens when it runs, and up to ~18k if it reads all its reference files. Until then it costs about 154 tokens; SKILL.md has 786 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~154
When it runs · the whole SKILL.md, loaded when a task matches
~3.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~18k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from espennilsen/pi at commit 79d019b, republished under its MIT licence (© espennilsen). 786 words, ~3,381 tokens.

Download SKILL.mdSave it as .claude/skills/google-workspace/SKILL.md (or your agent's skills folder). This skill also uses 77 other files; get the full folder from GitHub.
name
google-workspace
description
Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows. Use when asked to send email, read/write spreadsheets, upload files to Drive, manage contacts, create presentations, send Chat messages, create docs, or any Google Workspace operation. Also triggers on "gws", "Google Drive", "Google Sheets", "Gmail", "Google Docs", "Google Slides", "Google Chat", "Google Meet", "Google Forms", "check my inbox", "upload to Drive", "read spreadsheet", "send an email", "create a doc", "send a chat message", "create a presentation".

Google Workspace CLI (gws)

Interact with Google Workspace services via the gws CLI. This skill covers all supported services, helper shortcuts, cross-service workflows, role-based personas, and multi-step recipes.

Installation & Auth

The gws binary must be on $PATH. Version: 0.16.0+.

bash
# Browser-based OAuth (interactive)
gws auth login

# Service Account
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json

# Check status
gws auth status
Auth Flags
FlagDescription
--readonlyRequest read-only scopes
--fullRequest all scopes incl. pubsub + cloud-platform
--scopesComma-separated custom scopes
-s, --servicesLimit scope picker to specific services (e.g. -s drive,gmail)

CLI Syntax

bash
gws <service> <resource> [sub-resource] <method> [flags]
Global Flags
FlagDescription
--format <FMT>Output format: json (default), table, yaml, csv
--dry-runValidate locally without calling the API
--sanitize <TEMPLATE>Screen responses through Model Armor
--params '{"key": "val"}'URL/query parameters
--json '{"key": "val"}'Request body
-o, --output <PATH>Save binary responses to file
--upload <PATH>Upload file content (multipart)
--page-allAuto-paginate (NDJSON output)
--page-limit <N>Max pages with --page-all (default: 10)
--page-delay <MS>Delay between pages in ms (default: 100)
Discovering Commands
bash
gws <service> --help                    # Browse resources and methods
gws schema <service.resource.method>    # Inspect params, types, defaults

Shell Tips

  • zsh ! expansion: Use double quotes for sheet ranges: --range "Sheet1!A1:D10"
  • JSON with double quotes: Wrap --params/--json in single quotes: --params '{"pageSize": 5}'

Security Rules

  • Never output secrets (API keys, tokens) directly
  • Always confirm with user before executing write/delete commands
  • Prefer --dry-run for destructive operations
  • Use --sanitize for PII/content safety screening

Services

Core Google Workspace API skills. Read the reference file for full resource/method details.

ServiceDescriptionReference
DriveManage files, folders, shared drivesreferences/gws-drive.md
SheetsRead and write spreadsheetsreferences/gws-sheets.md
GmailSend, read, and manage emailreferences/gws-gmail.md
DocsRead and write Google Docsreferences/gws-docs.md
SlidesRead and write presentationsreferences/gws-slides.md
PeopleManage contacts and profilesreferences/gws-people.md
ChatManage Chat spaces and messagesreferences/gws-chat.md
MeetManage Google Meet conferencesreferences/gws-meet.md
FormsRead and write Google Formsreferences/gws-forms.md
Admin ReportsAudit logs and usage reportsreferences/gws-admin-reports.md
EventsSubscribe to Workspace eventsreferences/gws-events.md
KeepManage Google Keep notesreferences/gws-keep.md
ClassroomManage courses, students, and invitationsreferences/gws-classroom.md
Model ArmorFilter content for safetyreferences/gws-modelarmor.md
WorkflowCross-service productivity workflowsreferences/gws-workflow.md

Helper Shortcuts

Quick commands for common operations. Read the reference file for flags and examples.

Drive
CommandReference
gws drive +upload <file>references/gws-drive-upload.md
Sheets
CommandReference
gws sheets +read --spreadsheet ID --range RANGEreferences/gws-sheets-read.md
gws sheets +append --spreadsheet ID --values '...'references/gws-sheets-append.md
Gmail
CommandReference
gws gmail +send --to EMAIL --subject S --body Breferences/gws-gmail-send.md
gws gmail +triagereferences/gws-gmail-triage.md
gws gmail +reply --message-id ID --body TEXTreferences/gws-gmail-reply.md
gws gmail +reply-all --message-id ID --body TEXTreferences/gws-gmail-reply-all.md
gws gmail +forward --message-id ID --to EMAILreferences/gws-gmail-forward.md
gws gmail +watchreferences/gws-gmail-watch.md
Docs
CommandReference
gws docs +write --document ID --text TEXTreferences/gws-docs-write.md
Chat
CommandReference
gws chat +send --space NAME --text TEXTreferences/gws-chat-send.md
Events
CommandReference
gws events +subscribereferences/gws-events-subscribe.md
gws events +renewreferences/gws-events-renew.md
Model Armor
CommandReference
gws modelarmor +sanitize-prompt --template NAMEreferences/gws-modelarmor-sanitize-prompt.md
gws modelarmor +sanitize-response --template NAMEreferences/gws-modelarmor-sanitize-response.md
gws modelarmor +create-template --project P --location L --template-id IDreferences/gws-modelarmor-create-template.md
Workflow
CommandReference
gws workflow +standup-reportreferences/gws-workflow-standup-report.md
gws workflow +meeting-prepreferences/gws-workflow-meeting-prep.md
gws workflow +email-to-task --message-id IDreferences/gws-workflow-email-to-task.md
gws workflow +weekly-digestreferences/gws-workflow-weekly-digest.md
gws workflow +file-announce --file-id ID --space SPACEreferences/gws-workflow-file-announce.md
Show full SKILL.md (300 more words)Show less

Personas

Role-based skill bundles for common workflows. Read the reference for instructions.

PersonaDescriptionReference
Executive AssistantSchedule, inbox, and communicationsreferences/persona-exec-assistant.md
Project ManagerTasks, meetings, and doc sharingreferences/persona-project-manager.md
Team LeadStandups, coordination, and commsreferences/persona-team-lead.md
Sales OperationsDeal tracking, calls, client commsreferences/persona-sales-ops.md
Content CreatorCreate, organize, distribute contentreferences/persona-content-creator.md
Event CoordinatorScheduling, invitations, logisticsreferences/persona-event-coordinator.md
Customer SupportTickets, responses, escalationreferences/persona-customer-support.md
HR CoordinatorOnboarding, announcements, commsreferences/persona-hr-coordinator.md
IT AdministratorSecurity monitoring, configurationreferences/persona-it-admin.md
ResearcherReferences, notes, collaborationreferences/persona-researcher.md

Recipes

Multi-step task sequences with real commands. Read the reference for step-by-step instructions.

Gmail Recipes
Drive Recipes
Sheets Recipes
Cross-Service Recipes

Exit Codes

CodeMeaning
0Success
1API error — Google returned an error response
2Auth error — credentials missing or invalid
3Validation — bad arguments or input
4Discovery — could not fetch API schema
5Internal — unexpected failure

Community & Feedback

© espennilsen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 77 other files (references) in skills/google-workspace of espennilsen/pi.

  • SKILL.md
  • references/gws-admin-reports.md
  • references/gws-chat-send.md
  • references/gws-chat.md
  • references/gws-classroom.md
  • references/gws-docs-write.md
  • references/gws-docs.md
  • references/gws-drive-upload.md
  • references/gws-drive.md
  • references/gws-events-renew.md
  • references/gws-events-subscribe.md
  • references/gws-events.md
  • references/gws-forms.md
  • references/gws-gmail-forward.md
  • references/gws-gmail-reply-all.md
  • references/gws-gmail-reply.md
  • references/gws-gmail-send.md
  • references/gws-gmail-triage.md
  • references/gws-gmail-watch.md
  • references/gws-gmail.md
  • … and 58 more

Open the folder on GitHubat commit 79d019b

Compare with similar skills

Google Workspace next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Workspace compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Workspace this skillespennilsen/pi122—~3.4kAutomated safety check: PassMIT
Managing Google Workspacetaylorwilsdon/google_workspace_mcp3.3k—~2.9kAutomated safety check: PassMIT
Google Workspacetaracodlabs/aiden851—~1.1kAutomated safety check: PassApache-2.0
Gwskv0906/pm-kit138—~1.6kAutomated safety check: PassMIT
Google Docs, Sheets and Slides Editingasgeirtj/system_prompts_leaks69k—~3.5kAutomated safety check: WarnCC0-1.0
Recipe Generate Report From Sheetgoogleworkspace/cli31k—~287Automated safety check: PassApache-2.0

Similar skills

  • Managing Google Workspace

    taylorwilsdon/google_workspace_mcp

    Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search).

    3.3k GitHub stars~2.9k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Google Workspace

    taracodlabs/aiden

    Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth)

    851 GitHub stars~1.1k tokensUpdated 25 days ago
    Documents & OfficeAuto-check passed
  • Gws

    kv0906/pm-kit

    This skill should be used when the user asks to "set up gws", "install Google Workspace CLI", "connect Gmail to Claude", "manage Google Drive from terminal", "send email from CLI", "check my…

    138 GitHub stars~1.6k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Google Docs, Sheets and Slides Editing

    asgeirtj/system_prompts_leaks

    Guidance for creating and editing Google Docs, Sheets and Slides through connectors, with per-app API rules and helper scripts for positions, ranges and slide layout.

    69k GitHub stars~3.5k tokensUpdated today
    Documents & OfficeAuto-check: warnings
  • Read data from a Google Sheet and create a formatted Google Docs report.

    31k GitHub stars~287 tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed
  • Nopal

    fivetaku/gptaku-plugins-codex

    Codex용 Google Workspace 오케스트레이션 스킬. An agent skill from fivetaku/gptaku-plugins-codex.

    128 GitHub stars~4.8k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from espennilsen/pi

All 36 skills in this repo
  • GitHub

    espennilsen/pi

    Interact with GitHub repos, PRs, issues, CI, and notifications via the pi-github extension commands and gh CLI.

    122 GitHub stars~1k tokensUpdated 17 days ago
    Auto-check passed
  • Skill Creator

    espennilsen/pi

    Create, review, and improve skills for Pi agents. An agent skill from espennilsen/pi.

    122 GitHub stars~2.1k tokensUpdated 17 days ago
    Auto-check passed
  • Dry Code Review

    espennilsen/pi

    Perform a comprehensive DRY (Don't Repeat Yourself) code review on a codebase.

    122 GitHub stars~1.7k tokensUpdated 17 days ago
    Auto-check passed
  • Extract Design System

    espennilsen/pi

    Reverse-engineer a design system from a live website (public URL or localhost).

    122 GitHub stars~2k tokensUpdated 17 days ago
    Auto-check passed
  • Herdr Operations

    espennilsen/pi

    A skill your agent uses when inspecting or operating Herdr sessions, workspaces, tabs, panes, agents, terminal output, agent messaging, or waits.

    122 GitHub starsUsed in 1 repo~525 tokens
    Auto-check passed
  • PDF Reader

    espennilsen/pi

    Read and extract content from PDF files — text, tables, metadata, and images.

    122 GitHub stars~1.6k tokensUpdated 17 days ago
    Auto-check passed

Questions about Google Workspace

What does Google Workspace do?

Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows. Google Workspace is an agent skill from espennilsen/pi. Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows.

When should I use Google Workspace?

Google Workspace fits situations like: asked to send email; read/write spreadsheets; upload files to Drive; manage contacts.

How do I install Google Workspace in Claude Code?

Run `npx skills add espennilsen/pi --skill google-workspace -a claude-code`. Or copy the skill folder (skills/google-workspace in espennilsen/pi) into .claude/skills/google-workspace in your project. Claude Code loads it when a task matches its description.

How do I install Google Workspace in Codex?

Run `npx skills add espennilsen/pi --skill google-workspace -a codex`. Or copy the skill folder (skills/google-workspace in espennilsen/pi) into .agents/skills/google-workspace in your project. Codex loads it when a task matches its description.

Can I use Google Workspace in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add espennilsen/pi --skill google-workspace -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-workspace, .gemini/skills/google-workspace, .github/skills/google-workspace and .opencode/skills/google-workspace in your project.

What does Google Workspace need to run?

Going by SKILL.md and its folder, Google Workspace needs credentials named GOOGLE_APPLICATION_CREDENTIALS.

Does Google Workspace access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Google Workspace safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Google Workspace use?

Google Workspace is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Workspace use?

About 3.4k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 15k tokens, read only when the agent opens those files.

What are the alternatives to Google Workspace?

Skills that share tags, products or a category with Google Workspace: Managing Google Workspace (taylorwilsdon/google_workspace_mcp, 3.3k stars), Google Workspace (taracodlabs/aiden, 851 stars), Gws (kv0906/pm-kit, 138 stars) and Google Docs, Sheets and Slides Editing (asgeirtj/system_prompts_leaks, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Workspace?

espennilsen (a GitHub user) maintains it in espennilsen/pi, which has 122 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 21, 2026.

Source: espennilsen/pi on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.