Skip to content
Development
Skill

/gws-gmail

Gmail: Send, read, and manage email.

From plugin
cli
32k95 skills

Claude Code

$ npx -y skills add googleworkspace/cli --skill gws-gmail --agent claude-code

SKILL.md

gws-gmail.SKILL.md
name: gws-gmail
description: "Gmail: Send, read, and manage email."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws gmail --help"

gmail (v1)

> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

gws gmail <resource> <method> [flags]

Helper Commands

| Command | Description | |---------|-------------| | [`+send`](../gws-gmail-send/SKILL.md) | Send an email | | [`+triage`](../gws-gmail-triage/SKILL.md) | Show unread inbox summary (sender, subject, date) | | [`+reply`](../gws-gmail-reply/SKILL.md) | Reply to a message (handles threading automatically) | | [`+reply-all`](../gws-gmail-reply-all/SKILL.md) | Reply-all to a message (handles threading automatically) | | [`+forward`](../gws-gmail-forward/SKILL.md) | Forward a message to new recipients | | [`+read`](../gws-gmail-read/SKILL.md) | Read a message and extract its body or headers | | [`+watch`](../gws-gmail-watch/SKILL.md) | Watch for new emails and stream them as NDJSON |

API Resources

users

  • `getProfile` — Gets the current user's Gmail profile.
  • `stop` — Stop receiving push notifications for the given user mailbox.
  • `watch` — Set up or update a push notification watch on the given user mailbox.
  • `drafts` — Operations on the 'drafts' resource
  • `history` — Operations on the 'history' resource
  • `labels` — Operations on the 'labels' resource
  • `messages` — Operations on the 'messages' resource
  • `settings` — Operations on the 'settings' resource
  • `threads` — Operations on the 'threads' resource

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws gmail --help

# Inspect a method's required params, types, and defaults
gws schema gmail.<resource>.<method>

Use `gws schema` output to build your `--params` and `--json` flags.

Read more
@googleworkspace
Ships withcli

Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.

Stars on GitHub

Momentum

stars in total
32.1k
Star history of googleworkspace/cli on GitHub, a chart by star-history.com

Other skills on cli.

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills11d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc13d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react2d252k
@facebook@facebookInstall Skill

Questions about gws-gmail.

Which coding agents can use gws-gmail?
gws-gmail installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.