File contents 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
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
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 (, , , , etc.) — no / wrapper needed.
[!CAUTION]
This is a write command — confirm with the user before executing.
See Also
1 --- 2 name: gws-gmail-send 3 version: 1.0.0 4 description: "Gmail: Send an email." 5 metadata: 6 source: https://skillmd.com/skills/googleworkspace/gws-gmail-send 7 openclaw: 8 category: "productivity" 9 requires: 10 bins: ["gws"] 11 cliHelp: "gws gmail +send --help" 12 --- 13 14 # gmail +send 15 16 > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. 17 18 Send an email 19 20 ## Usage 21 22 ```bash 23 gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT> 24 ``` 25 26 ## Flags 27 28 | Flag | Required | Default | Description | 29 |------|----------|---------|-------------| 30 | `--to` | ✓ | — | Recipient email address(es), comma-separated | 31 | `--subject` | ✓ | — | Email subject | 32 | `--body` | ✓ | — | Email body (plain text, or HTML with --html) | 33 | `--from` | — | — | Sender address (for send-as/alias; omit to use account default) | 34 | `--attach` | — | — | Attach a file (can be specified multiple times) | 35 | `--cc` | — | — | CC email address(es), comma-separated | 36 | `--bcc` | — | — | BCC email address(es), comma-separated | 37 | `--html` | — | — | Treat --body as HTML content (default is plain text) | 38 | `--dry-run` | — | — | Show the request that would be sent without executing it | 39 40 ## Examples 41 42 ```bash 43 gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!' 44 gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --cc bob@example.com 45 gws gmail +send --to alice@example.com --subject 'Hello' --body '<b>Bold</b> text' --html 46 gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --from alias@example.com 47 gws gmail +send --to alice@example.com --subject 'Report' --body 'See attached' -a report.pdf 48 gws gmail +send --to alice@example.com --subject 'Files' --body 'Two files' -a a.pdf -a b.csv 49 ``` 50 51 ## Tips 52 53 - Handles RFC 5322 formatting, MIME encoding, and base64 automatically. 54 - Use --from to send from a configured send-as alias instead of your primary address. 55 - Use -a/--attach to add file attachments. Can be specified multiple times. Total size limit: 25MB. 56 - With --html, use fragment tags (<p>, <b>, <a>, <br>, etc.) — no <html>/<body> wrapper needed. 57 58 > [!CAUTION] 59 > This is a **write** command — confirm with the user before executing. 60 61 ## See Also 62 63 - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth 64 - [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands 65
googleworkspace/cli commit 23e76d8bc5
Frequently asked questions How do I install the Gws Gmail Send skill? Run npx get-skill add googleworkspace/gws-gmail-send in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Gws Gmail Send skill do? Gmail: Send an email. It is listed under Productivity on SkillMD.
Is Gws Gmail Send safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Gws Gmail Send? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Gws Gmail Send free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Gws Gmail Send? googleworkspace (@googleworkspace) published this skill. Their other Agent Skills are listed on their SkillMD profile.