gws-gmail-send▌
googleworkspace/cli · updated Apr 8, 2026
Send emails via Gmail with support for attachments, HTML formatting, and send-as aliases.
- ›Requires recipient email(s), subject, and body text; supports CC, BCC, and optional sender address for send-as aliases
- ›Handles file attachments up to 25MB total, with multiple files supported via repeated --attach flags
- ›Supports both plain text and HTML email bodies; HTML fragments do not require wrapper tags
- ›Includes --dry-run flag to preview the request before sending, and automatic RFC 532
gmail +send
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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 (, , , , etc.) — no / 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 — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.7★★★★★38 reviews- ★★★★★Layla Reddy· Dec 24, 2024
We added gws-gmail-send from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Shikha Mishra· Dec 16, 2024
gws-gmail-send has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Liam Shah· Dec 12, 2024
Solid pick for teams standardizing on skills: gws-gmail-send is focused, and the summary matches what you get after install.
- ★★★★★Isabella Yang· Dec 8, 2024
Keeps context tight: gws-gmail-send is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Arjun Sethi· Nov 27, 2024
I recommend gws-gmail-send for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Kofi Reddy· Nov 15, 2024
Useful defaults in gws-gmail-send — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Layla Mehta· Nov 11, 2024
gws-gmail-send fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Yash Thakker· Nov 7, 2024
Solid pick for teams standardizing on skills: gws-gmail-send is focused, and the summary matches what you get after install.
- ★★★★★Liam Khanna· Nov 3, 2024
gws-gmail-send has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Dhruvi Jain· Oct 26, 2024
We added gws-gmail-send from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
showing 1-10 of 38