gws-gmail

Install Gmail (gws)

npx skills add googleworkspace/cli --skill gws-gmail

npx skills add googleworkspace/cli --skill gws-shared

npm install -g @googleworkspace/cli

gemini extensions install https://github.com/googleworkspace/cli

Or paste this into your coding agent: Install the agent skill gws-gmail from github.com/googleworkspace/cli. A skill can include scripts that run on your computer, so read its source first.

What Gmail (gws) does

Gmail (gws) is one of more than 100 skills in the googleworkspace/cli repository, which builds a single gws command for every Google Workspace API from Google's Discovery Service. This skill covers Gmail. It gives the agent helper commands to send, reply, reply to all, forward, read a message's body or headers, show an unread inbox summary, and stream new mail as it arrives.

Beyond the helpers, the agent can reach the full Gmail API: drafts, labels, threads, messages, history and settings. Before calling a method, it is told to run gws schema on that method to see the required parameters, then pass them as JSON. Helper commands have their own small skills, such as gws-gmail-send and gws-gmail-triage, linked from this one.

The companion gws-shared skill sets the safety rules: never print tokens, always confirm with you before a write or delete, prefer a dry run for destructive actions, and optionally screen responses through Google's Model Armor. Output is JSON by default, with table, YAML and CSV available.

When to use Gmail (gws)

• You want your agent to summarize unread email in your inbox.
• You want a reply drafted and sent in the right thread after you approve it.
• You want labels or filters managed from the terminal.
• You want an agent to watch for new mail and act on it.

When to pick something else

• Quick setup on a personal Gmail account: you need your own Google Cloud OAuth app, and unverified apps are limited to about 25 scopes, so the broad scope preset fails.

What Gmail (gws) needs

• The gws CLI (a release binary, or npm install -g @googleworkspace/cli)
• A Google Cloud project with OAuth credentials, set up with gws auth setup or the Cloud Console

Which agents Gmail (gws) works in

Google Workspace documents Gmail (gws) for Gemini CLI, OpenClaw, Any agent that reads SKILL.md files, through the skills CLI. The open skills CLI also installs it into 78 agents, including Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode (we listed it with the CLI on October 1, 2026). See where each agent looks for skills.

gws-gmail tells the agent to read a companion skill, gws-shared, for login, global flags and safety rules first, so install both.

Gmail (gws) license

Gmail (gws) is published under Apache-2.0. Apache-2.0 per the repository. The README says gws is not an officially supported Google product and expects breaking changes before version 1.0.

Related skills for writing

• Doc Co-Authoring: Doc Co-Authoring is Anthropic's agent skill that takes you and an AI agent through a document in three stages: gather context, draft section by section, then test it on a fresh reader. (179,326 repository stars on October 2, 2026)
• Internal Comms: Internal Comms is Anthropic's open-source agent skill for writing inside a company: the agent drafts 3P updates, company newsletters, FAQs and other internal messages in set formats. (179,326 repository stars on October 2, 2026)
• Writing Guidelines: Writing Guidelines is Vercel's agent skill for docs review: the agent checks your pages against Vercel's Writing Guidelines and lists each style or tone issue by file and line. (31,813 repository stars on October 2, 2026)

Lists that include gws-gmail

• Agent skills with a permissive license
• Agent skills for work that is not code