Skip to content
Development
Skill

/gws-gmail-send

Gmail: Send an email.

Boost this skill
@googleworkspacegoogleworkspace@googleworkspace
From plugin
googleworkspace-cli
31k95 skills
Install
$ npx -y skills add googleworkspace/cli --skill gws-gmail-send --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/gws-gmail-send

Context preview

The summary Claude sees to decide when to auto-load this skill.

Gmail: Send an email.

SKILL.md

gws-gmail-send.SKILL.md
name: gws-gmail-send
description: "Gmail: Send an email."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws gmail +send --help"

gmail +send

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

Send an email

Usage

gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT>

Flags

| Flag | Required | Default | Description | |------|----------|---------|-------------| | `--to` | ✓ | — | Recipient email address(es), comma-separated | | `--subject` | ✓ | — | Email subject | | `--body` | ✓ | — | Email body (plain text, or HTML with --html) | | `--from` | — | — | Sender address (for send-as/alias; omit to use account default) | | `--attach` | — | — | Attach a file (can be specified multiple times) | | `--cc` | — | — | CC email address(es), comma-separated | | `--bcc` | — | — | BCC email address(es), comma-separated | | `--html` | — | — | Treat --body as HTML content (default is plain text) | | `--dry-run` | — | — | Show the request that would be sent without executing it | | `--draft` | — | — | Save as draft instead of sending |

Examples

gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!'
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --cc bob@example.com
gws gmail +send --to alice@example.com --subject 'Hello' --body '<b>Bold</b> text' --html
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --from alias@example.com
gws gmail +send --to alice@example.com --subject 'Report' --body 'See attached' -a report.pdf
gws gmail +send --to alice@example.com --subject 'Files' --body 'Two files' -a a.pdf -a b.csv
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --draft

Tips

  • Handles RFC 5322 formatting, MIME encoding, and base64 automatically.
  • Use --from to send from a configured send-as alias instead of your primary address.
  • Use -a/--attach to add file attachments. Can be specified multiple times. Total size limit: 25MB.
  • With --html, use fragment tags (<p>, <b>, <a>, <br>, etc.) — no <html>/<body> wrapper needed.
  • Use --draft to save the message as a draft instead of sending it immediately.

> [!CAUTION] > This is a **write** command — confirm with the user before executing.

See Also

  • [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
  • [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands
Read more
Read it on GitHub ↗
Ships withgoogleworkspace-cli

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.

Get the whole plugin
Stats
JavaScriptNodeHTMLBashRust
+5 tags
GCPLinuxGitGitHubGemini
31,012
Stars
1,833
Forks
Active
Maintenance
Rust
Language
Apache-2.0
License
1d ago
Last commit
6mo ago
Created

Repo: googleworkspace/cli

In this plugin
95 skills
See everything inside

Other skills on googleworkspace-cli.

See all 95 skills in googleworkspace-cli