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).
Manage Google Workspace via the gws CLI — Drive, Gmail, Sheets, Docs, Slides, People, Chat, Meet, Forms, and cross-service workflows.
$ npx skills add espennilsen/pi --skill google-workspace -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install espennilsen/pi google-workspace --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-srcUse ~/.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/
Install the "google-workspace" agent skill from https://github.com/espennilsen/pi/tree/main/skills/google-workspace into .claude/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/espennilsen/pi/tree/main/skills/google-workspaceType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add espennilsen/pi --skill google-workspace -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install espennilsen/pi google-workspace --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/google-workspace .agents/skills/google-workspace && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "google-workspace" agent skill from https://github.com/espennilsen/pi/tree/main/skills/google-workspace into .agents/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add espennilsen/pi --skill google-workspace -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install espennilsen/pi google-workspace --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/google-workspace .cursor/skills/google-workspace && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "google-workspace" agent skill from https://github.com/espennilsen/pi/tree/main/skills/google-workspace into .cursor/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/espennilsen/pi.git --path skills/google-workspace--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add espennilsen/pi --skill google-workspace -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install espennilsen/pi google-workspace --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/google-workspace .gemini/skills/google-workspace && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "google-workspace" agent skill from https://github.com/espennilsen/pi/tree/main/skills/google-workspace into .gemini/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install espennilsen/pi google-workspaceInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add espennilsen/pi --skill google-workspace -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/google-workspace .github/skills/google-workspace && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "google-workspace" agent skill from https://github.com/espennilsen/pi/tree/main/skills/google-workspace into .github/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add espennilsen/pi --skill google-workspace -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install espennilsen/pi google-workspace --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/espennilsen/pi.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/google-workspace .opencode/skills/google-workspace && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "google-workspace" agent skill from https://github.com/espennilsen/pi/tree/main/skills/google-workspace into .opencode/skills/google-workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-workspace", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
google-workspaceManage 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. 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.
Read from SKILL.md and the folder at commit 79d019b. It shows what the files ask for, not the result of running them.
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.
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.
Links to these hosts (documentation or services it may open):
github.comFrom URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
GOOGLE_APPLICATION_CREDENTIALSFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
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.
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.
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.
The full file from espennilsen/pi at commit 79d019b, republished under its MIT licence (© espennilsen). 786 words, ~3,381 tokens.
.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.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.
The gws binary must be on $PATH. Version: 0.16.0+.
# Browser-based OAuth (interactive)
gws auth login
# Service Account
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json
# Check status
gws auth status| Flag | Description |
|---|---|
--readonly | Request read-only scopes |
--full | Request all scopes incl. pubsub + cloud-platform |
--scopes | Comma-separated custom scopes |
-s, --services | Limit scope picker to specific services (e.g. -s drive,gmail) |
gws <service> <resource> [sub-resource] <method> [flags]| Flag | Description |
|---|---|
--format <FMT> | Output format: json (default), table, yaml, csv |
--dry-run | Validate 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-all | Auto-paginate (NDJSON output) |
--page-limit <N> | Max pages with --page-all (default: 10) |
--page-delay <MS> | Delay between pages in ms (default: 100) |
gws <service> --help # Browse resources and methods
gws schema <service.resource.method> # Inspect params, types, defaults! expansion: Use double quotes for sheet ranges: --range "Sheet1!A1:D10"--params/--json in single quotes: --params '{"pageSize": 5}'--dry-run for destructive operations--sanitize for PII/content safety screeningCore Google Workspace API skills. Read the reference file for full resource/method details.
| Service | Description | Reference |
|---|---|---|
| Drive | Manage files, folders, shared drives | references/gws-drive.md |
| Sheets | Read and write spreadsheets | references/gws-sheets.md |
| Gmail | Send, read, and manage email | references/gws-gmail.md |
| Docs | Read and write Google Docs | references/gws-docs.md |
| Slides | Read and write presentations | references/gws-slides.md |
| People | Manage contacts and profiles | references/gws-people.md |
| Chat | Manage Chat spaces and messages | references/gws-chat.md |
| Meet | Manage Google Meet conferences | references/gws-meet.md |
| Forms | Read and write Google Forms | references/gws-forms.md |
| Admin Reports | Audit logs and usage reports | references/gws-admin-reports.md |
| Events | Subscribe to Workspace events | references/gws-events.md |
| Keep | Manage Google Keep notes | references/gws-keep.md |
| Classroom | Manage courses, students, and invitations | references/gws-classroom.md |
| Model Armor | Filter content for safety | references/gws-modelarmor.md |
| Workflow | Cross-service productivity workflows | references/gws-workflow.md |
Quick commands for common operations. Read the reference file for flags and examples.
| Command | Reference |
|---|---|
gws drive +upload <file> | references/gws-drive-upload.md |
| Command | Reference |
|---|---|
gws sheets +read --spreadsheet ID --range RANGE | references/gws-sheets-read.md |
gws sheets +append --spreadsheet ID --values '...' | references/gws-sheets-append.md |
| Command | Reference |
|---|---|
gws gmail +send --to EMAIL --subject S --body B | references/gws-gmail-send.md |
gws gmail +triage | references/gws-gmail-triage.md |
gws gmail +reply --message-id ID --body TEXT | references/gws-gmail-reply.md |
gws gmail +reply-all --message-id ID --body TEXT | references/gws-gmail-reply-all.md |
gws gmail +forward --message-id ID --to EMAIL | references/gws-gmail-forward.md |
gws gmail +watch | references/gws-gmail-watch.md |
| Command | Reference |
|---|---|
gws docs +write --document ID --text TEXT | references/gws-docs-write.md |
| Command | Reference |
|---|---|
gws chat +send --space NAME --text TEXT | references/gws-chat-send.md |
| Command | Reference |
|---|---|
gws events +subscribe | references/gws-events-subscribe.md |
gws events +renew | references/gws-events-renew.md |
| Command | Reference |
|---|---|
gws modelarmor +sanitize-prompt --template NAME | references/gws-modelarmor-sanitize-prompt.md |
gws modelarmor +sanitize-response --template NAME | references/gws-modelarmor-sanitize-response.md |
gws modelarmor +create-template --project P --location L --template-id ID | references/gws-modelarmor-create-template.md |
| Command | Reference |
|---|---|
gws workflow +standup-report | references/gws-workflow-standup-report.md |
gws workflow +meeting-prep | references/gws-workflow-meeting-prep.md |
gws workflow +email-to-task --message-id ID | references/gws-workflow-email-to-task.md |
gws workflow +weekly-digest | references/gws-workflow-weekly-digest.md |
gws workflow +file-announce --file-id ID --space SPACE | references/gws-workflow-file-announce.md |
Role-based skill bundles for common workflows. Read the reference for instructions.
| Persona | Description | Reference |
|---|---|---|
| Executive Assistant | Schedule, inbox, and communications | references/persona-exec-assistant.md |
| Project Manager | Tasks, meetings, and doc sharing | references/persona-project-manager.md |
| Team Lead | Standups, coordination, and comms | references/persona-team-lead.md |
| Sales Operations | Deal tracking, calls, client comms | references/persona-sales-ops.md |
| Content Creator | Create, organize, distribute content | references/persona-content-creator.md |
| Event Coordinator | Scheduling, invitations, logistics | references/persona-event-coordinator.md |
| Customer Support | Tickets, responses, escalation | references/persona-customer-support.md |
| HR Coordinator | Onboarding, announcements, comms | references/persona-hr-coordinator.md |
| IT Administrator | Security monitoring, configuration | references/persona-it-admin.md |
| Researcher | References, notes, collaboration | references/persona-researcher.md |
Multi-step task sequences with real commands. Read the reference for step-by-step instructions.
| Recipe | Reference |
|---|---|
| Label and archive emails | references/recipe-label-and-archive-emails.md |
| Create Gmail filter | references/recipe-create-gmail-filter.md |
| Forward labeled emails | references/recipe-forward-labeled-emails.md |
| Set vacation responder | references/recipe-create-vacation-responder.md |
| Save email attachments to Drive | references/recipe-save-email-attachments.md |
| Save email to Google Doc | references/recipe-save-email-to-doc.md |
| Draft email from Doc | references/recipe-draft-email-from-doc.md |
| Recipe | Reference |
|---|---|
| Organize Drive folder | references/recipe-organize-drive-folder.md |
| Share folder with team | references/recipe-share-folder-with-team.md |
| Email a Drive link | references/recipe-email-drive-link.md |
| Bulk download folder | references/recipe-bulk-download-folder.md |
| Find large files | references/recipe-find-large-files.md |
| Create shared drive | references/recipe-create-shared-drive.md |
| Watch Drive changes | references/recipe-watch-drive-changes.md |
| Recipe | Reference |
|---|---|
| Create expense tracker | references/recipe-create-expense-tracker.md |
| Copy sheet for new month | references/recipe-copy-sheet-for-new-month.md |
| Log deal update | references/recipe-log-deal-update.md |
| Compare sheet tabs | references/recipe-compare-sheet-tabs.md |
| Backup sheet as CSV | references/recipe-backup-sheet-as-csv.md |
| Sync contacts to sheet | references/recipe-sync-contacts-to-sheet.md |
| Generate report from sheet | references/recipe-generate-report-from-sheet.md |
| Recipe | Reference |
|---|---|
| Create doc from template | references/recipe-create-doc-from-template.md |
| Share doc and notify | references/recipe-share-doc-and-notify.md |
| Send team announcement | references/recipe-send-team-announcement.md |
| Create feedback form | references/recipe-create-feedback-form.md |
| Create Meet space | references/recipe-create-meet-space.md |
| Review Meet participants | references/recipe-review-meet-participants.md |
| Create presentation | references/recipe-create-presentation.md |
| Collect form responses | references/recipe-collect-form-responses.md |
| Create classroom course | references/recipe-create-classroom-course.md |
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | API error — Google returned an error response |
| 2 | Auth error — credentials missing or invalid |
| 3 | Validation — bad arguments or input |
| 4 | Discovery — could not fetch API schema |
| 5 | Internal — unexpected failure |
© espennilsen, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 77 other files (references) in skills/google-workspace of espennilsen/pi.
Open the folder on GitHubat commit 79d019b
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Google Workspace this skillespennilsen/pi | 122 | — | ~3.4k | Automated safety check: Pass | MIT | |
| Managing Google Workspacetaylorwilsdon/google_workspace_mcp | 3.3k | — | ~2.9k | Automated safety check: Pass | MIT | |
| Google Workspacetaracodlabs/aiden | 851 | — | ~1.1k | Automated safety check: Pass | Apache-2.0 | |
| Gwskv0906/pm-kit | 138 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Google Docs, Sheets and Slides Editingasgeirtj/system_prompts_leaks | 69k | — | ~3.5k | Automated safety check: Warn | CC0-1.0 | |
| Recipe Generate Report From Sheetgoogleworkspace/cli | 31k | — | ~287 | Automated safety check: Pass | Apache-2.0 |
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).
taracodlabs/aiden
Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth)
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…
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.
googleworkspace/cli
Read data from a Google Sheet and create a formatted Google Docs report.
fivetaku/gptaku-plugins-codex
Codex용 Google Workspace 오케스트레이션 스킬. An agent skill from fivetaku/gptaku-plugins-codex.
espennilsen/pi
Interact with GitHub repos, PRs, issues, CI, and notifications via the pi-github extension commands and gh CLI.
espennilsen/pi
Create, review, and improve skills for Pi agents. An agent skill from espennilsen/pi.
espennilsen/pi
Perform a comprehensive DRY (Don't Repeat Yourself) code review on a codebase.
espennilsen/pi
Reverse-engineer a design system from a live website (public URL or localhost).
espennilsen/pi
A skill your agent uses when inspecting or operating Herdr sessions, workspaces, tabs, panes, agents, terminal output, agent messaging, or waits.
espennilsen/pi
Read and extract content from PDF files — text, tables, metadata, and images.
Categories
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.
Google Workspace fits situations like: asked to send email; read/write spreadsheets; upload files to Drive; manage contacts.
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.
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.
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.
Going by SKILL.md and its folder, Google Workspace needs credentials named GOOGLE_APPLICATION_CREDENTIALS.
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
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.
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.
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.
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.
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.