gws-gmail
gws-gmail is a skill in googleworkspace/cli, last changed 31 Mar 2026. It can run shell commands. Our pattern check flagged nothing at commit a3768d0 on 26 Oct 2026.
Pattern check: nothing flagged · commit a3768d0 · 26 Oct 2026
InstallGmail: Send, read, and manage email.
- Licence
- Apache 2.0
- Repo stars
- 31.9k
- Folder last changed
- 31 Mar 2026 (opens in a new tab)
- Publisher
- googleworkspace
- Files
- 1 file
- Checked
- a3768d0 (opens in a new tab) · 26 Oct 2026
Install
Each tab says whether it installs commit a3768d0, the one we checked, or the latest version.
No tab for your agent? Use Any agent for OpenCode, Goose, Windsurf (Devin Desktop), Zed, Roo Code, Factory Droid, Junie, Amp and Antigravity, and Claude Code for Cline. Kiro needs the folder copied by hand.
Pinned to commit a3768d0, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/googleworkspace/cli.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
git -C "$tmp" sparse-checkout set -- skills/gws-gmail &&
git -C "$tmp" checkout -q a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
mkdir -p .claude/skills &&
mkdir .claude/skills/gws-gmail &&
cp -R "$tmp"/skills/gws-gmail/. .claude/skills/gws-gmail/ &&
rm -rf "$tmp"If Claude Code was already running and this created the skills folder, run /reload-skills.
Pinned to commit a3768d0, the one we checked.
Skills in the Claude apps belong to your account rather than to a project.
Make gws-gmail.zip, with the skill folder at the top level:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/googleworkspace/cli.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
git -C "$tmp" sparse-checkout set -- skills/gws-gmail &&
git -C "$tmp" checkout -q a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
out="$(mktemp -d)" &&
cp -R "$tmp"/skills/gws-gmail "$out"/gws-gmail &&
(cd "$out" && zip -qr - gws-gmail) > gws-gmail.zip &&
rm -rf "$tmp" "$out"In Claude, open Customize > Skills, select +, then + Create skill > Upload a skill, and choose gws-gmail.zip.
On Free, Pro and Max plans, turn on Code execution and file creation (Create and edit files in newer settings) under Settings > Capabilities.
Pinned to commit a3768d0, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/googleworkspace/cli.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
git -C "$tmp" sparse-checkout set -- skills/gws-gmail &&
git -C "$tmp" checkout -q a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
mkdir -p .agents/skills &&
mkdir .agents/skills/gws-gmail &&
cp -R "$tmp"/skills/gws-gmail/. .agents/skills/gws-gmail/ &&
rm -rf "$tmp"Codex picks up new skills on its own; restart it if this one does not appear.
Pinned to commit a3768d0, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/googleworkspace/cli.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
git -C "$tmp" sparse-checkout set -- skills/gws-gmail &&
git -C "$tmp" checkout -q a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
mkdir -p .cursor/skills &&
mkdir .cursor/skills/gws-gmail &&
cp -R "$tmp"/skills/gws-gmail/. .cursor/skills/gws-gmail/ &&
rm -rf "$tmp"Pinned to commit a3768d0, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/googleworkspace/cli.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
git -C "$tmp" sparse-checkout set -- skills/gws-gmail &&
git -C "$tmp" checkout -q a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
mkdir -p .github/skills &&
mkdir .github/skills/gws-gmail &&
cp -R "$tmp"/skills/gws-gmail/. .github/skills/gws-gmail/ &&
rm -rf "$tmp"In a running Copilot CLI session, run /skills reload.
Or install it with gh skill, which also installs the commit we checked. Needs GitHub CLI 2.90 or later.
gh skill install googleworkspace/cli skills/gws-gmail/SKILL.md@a3768d0e82ad83cca2da97724e46bea4ff0e6dbd --agent github-copilot --scope projectPinned to commit a3768d0, the one we checked.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/googleworkspace/cli.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
git -C "$tmp" sparse-checkout set -- skills/gws-gmail &&
git -C "$tmp" checkout -q a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
mkdir -p .gemini/skills &&
mkdir .gemini/skills/gws-gmail &&
cp -R "$tmp"/skills/gws-gmail/. .gemini/skills/gws-gmail/ &&
rm -rf "$tmp"In a running session, run /skills reload.
Or use Gemini CLI’s own installer. Installs the latest version, not the one we checked.
gemini skills install https://github.com/googleworkspace/cli.git --path skills/gws-gmail --scope workspacePinned to commit a3768d0, the one we checked.
Codex, Cursor, Copilot, VS Code, Gemini CLI, OpenCode, Goose, Amp and Zed all read .agents/skills; Claude Code and Kiro list only their own folders.
From your project's root folder:
tmp="$(mktemp -d)" &&
git clone -q --depth 1 --filter=blob:none --no-checkout https://github.com/googleworkspace/cli.git "$tmp" &&
git -C "$tmp" fetch -q --depth 1 origin a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
git -C "$tmp" sparse-checkout set -- skills/gws-gmail &&
git -C "$tmp" checkout -q a3768d0e82ad83cca2da97724e46bea4ff0e6dbd &&
mkdir -p .agents/skills &&
mkdir .agents/skills/gws-gmail &&
cp -R "$tmp"/skills/gws-gmail/. .agents/skills/gws-gmail/ &&
rm -rf "$tmp"Or use the skills CLI from skills.sh. Installs the latest version, not the one we checked. The skills CLI reports installs to skills.sh unless you set DISABLE_TELEMETRY=1.
npx skills@1.7.4 add googleworkspace/cli --skill gws-gmailWhat it can touch
From the files and frontmatter at commit a3768d0. This is how much a skill can do, not whether it is risky.
What it can touch: Scripts or outside hosts
Runs shell commands
Its instructions or files give the agent commands to run on your computer.
Pattern check
Pattern check: nothing flagged · commit a3768d0 · 26 Oct 2026
We checked every text file in this skill, at commit a3768d0 on 26 Oct 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.
Format check
Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.
Agent Skills specPasses with warnings
The open format from agentskills.io, held to what the strictest agents enforce, so one folder loads everywhere.
- Warning
metadata values should be text; openclaw (a map) is not. The spec's validator turns them into text; other readers may not. O4
Fix: Quote each value, for example version: "1.0".
- Warning
Paths that may not work once the skill is installed: line 26: ../gws-gmail-send/SKILL.md (outside the skill folder), line 27: ../gws-gmail-triage/SKILL.md (outside the skill folder), line 28: ../gws-gmail-reply/SKILL.md (outside the skill folder), line 29: ../gws-gmail-reply-all/SKILL.md (outside the skill folder), line 30: ../gws-gmail-forward/SKILL.md (outside the skill folder) and 2 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Note
The description doesn't say when to use the skill. D6
Fix: Add a sentence such as "Use when …" naming the requests or files that should trigger it.
- Note
There is no license field, so readers can't tell whether they may reuse the skill. O2
Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.
- Warning
Claude CodePasses with warnings
Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.
- Warning
Paths that may not work once the skill is installed: line 26: ../gws-gmail-send/SKILL.md (outside the skill folder), line 27: ../gws-gmail-triage/SKILL.md (outside the skill folder), line 28: ../gws-gmail-reply/SKILL.md (outside the skill folder), line 29: ../gws-gmail-reply-all/SKILL.md (outside the skill folder), line 30: ../gws-gmail-forward/SKILL.md (outside the skill folder) and 2 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Warning
Claude apps & API uploadPasses with warnings
Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
- Warning
Paths that may not work once the skill is installed: line 26: ../gws-gmail-send/SKILL.md (outside the skill folder), line 27: ../gws-gmail-triage/SKILL.md (outside the skill folder), line 28: ../gws-gmail-reply/SKILL.md (outside the skill folder), line 29: ../gws-gmail-reply-all/SKILL.md (outside the skill folder), line 30: ../gws-gmail-forward/SKILL.md (outside the skill folder) and 2 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Note
metadata values should be text; openclaw (a map) is not. The spec defines metadata as text to text. O4
Fix: Quote each value, for example version: "1.0".
- Warning
OpenAI (Codex & API)Passes with warnings
Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.
- Warning
metadata values should be text; openclaw (a map) is not. OpenAI's upload follows the spec's text-to-text rule. O4
Fix: Quote each value, for example version: "1.0".
- Warning
Paths that may not work once the skill is installed: line 26: ../gws-gmail-send/SKILL.md (outside the skill folder), line 27: ../gws-gmail-triage/SKILL.md (outside the skill folder), line 28: ../gws-gmail-reply/SKILL.md (outside the skill folder), line 29: ../gws-gmail-reply-all/SKILL.md (outside the skill folder), line 30: ../gws-gmail-forward/SKILL.md (outside the skill folder) and 2 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Warning
VS Code & CopilotPasses with warnings
VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.
- Warning
Paths that may not work once the skill is installed: line 26: ../gws-gmail-send/SKILL.md (outside the skill folder), line 27: ../gws-gmail-triage/SKILL.md (outside the skill folder), line 28: ../gws-gmail-reply/SKILL.md (outside the skill folder), line 29: ../gws-gmail-reply-all/SKILL.md (outside the skill folder), line 30: ../gws-gmail-forward/SKILL.md (outside the skill folder) and 2 more. B6
Fix: Use forward-slash paths relative to SKILL.md, and copy shared files into the skill.
- Warning
SKILL.md
Files
1 file
| Path | Size |
|---|---|
| SKILL.md (opens in a new tab) | 2 KB |
More from googleworkspace/cli
gws-admin-reports
googleworkspace/cli
Google Workspace Admin SDK: Audit logs and usage reports.
Pattern check: Nothing flaggedWhat it can touch: Runs shell commandsApache 2.0 · 31.9k repo stars · Updated 31 Mar 2026
gws-calendar
googleworkspace/cli
Google Calendar: Manage calendars and events.
Pattern check: Nothing flaggedWhat it can touch: Runs shell commandsApache 2.0 · 31.9k repo stars · Updated 31 Mar 2026
gws-calendar-agenda
googleworkspace/cli
Google Calendar: Show upcoming events across all calendars.
Pattern check: Nothing flaggedWhat it can touch: Runs shell commandsApache 2.0 · 31.9k repo stars · Updated 31 Mar 2026
gws-calendar-insert
googleworkspace/cli
Google Calendar: Create a new event.
Pattern check: Nothing flaggedWhat it can touch: Runs shell commandsApache 2.0 · 31.9k repo stars · Updated 31 Mar 2026
gws-chat
googleworkspace/cli
Google Chat: Manage Chat spaces and messages.
Pattern check: Nothing flaggedWhat it can touch: Runs shell commands · Names web addressesApache 2.0 · 31.9k repo stars · Updated 31 Mar 2026
gws-chat-send
googleworkspace/cli
Google Chat: Send a message to a space.
Pattern check: Nothing flaggedWhat it can touch: Runs shell commandsApache 2.0 · 31.9k repo stars · Updated 31 Mar 2026