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 description: Gmail: Send an email. 4 --- 5 6 # gmail +send 7 8 > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. 9 10 Send an email 11 12 ## Usage 13 14 ```bash 15 gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT> 16 ``` 17 18 ## Flags 19 20 | Flag | Required | Default | Description | 21 |------|----------|---------|-------------| 22 | `--to` | ✓ | — | Recipient email address(es), comma-separated | 23 | `--subject` | ✓ | — | Email subject | 24 | `--body` | ✓ | — | Email body (plain text, or HTML with --html) | 25 | `--from` | — | — | Sender address (for send-as/alias; omit to use account default) | 26 | `--attach` | — | — | Attach a file (can be specified multiple times) | 27 | `--cc` | — | — | CC email address(es), comma-separated | 28 | `--bcc` | — | — | BCC email address(es), comma-separated | 29 | `--html` | — | — | Treat --body as HTML content (default is plain text) | 30 | `--dry-run` | — | — | Show the request that would be sent without executing it | 31 32 ## Examples 33 34 ```bash 35 gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!' 36 gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --cc bob@example.com 37 gws gmail +send --to alice@example.com --subject 'Hello' --body '<b>Bold</b> text' --html 38 gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --from alias@example.com 39 gws gmail +send --to alice@example.com --subject 'Report' --body 'See attached' -a report.pdf 40 gws gmail +send --to alice@example.com --subject 'Files' --body 'Two files' -a a.pdf -a b.csv 41 ``` 42 43 ## Tips 44 45 - Handles RFC 5322 formatting, MIME encoding, and base64 automatically. 46 - Use --from to send from a configured send-as alias instead of your primary address. 47 - Use -a/--attach to add file attachments. Can be specified multiple times. Total size limit: 25MB. 48 - With --html, use fragment tags (<p>, <b>, <a>, <br>, etc.) — no <html>/<body> wrapper needed. 49 50 > [!CAUTION] 51 > This is a **write** command — confirm with the user before executing. 52 53 ## See Also 54 55 - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth 56 - [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands 57
commit 23e76d8bc5
Frequently asked questions How do I install the Gws Gmail Send skill? Run npx skillmds@latest 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.
googleworkspace