Gws Gmail Send
- 64.8k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
gws-gmail-send is an agent skill for sending Gmail via the gws CLI with recipients, subject, body, attachments, HTML, drafts, and dry-run preview.
About
The gws-gmail-send skill documents the Gmail send command for the Google Workspace gws CLI, version 0.22.5 in the productivity category. It requires reading the shared gws-shared SKILL.md first for authentication, global flags, and security rules, or running gws generate-skills if that file is missing. The command sends email with required to, subject, and body flags plus optional from alias, attachments, CC, BCC, HTML body mode, dry-run preview, and draft saving. Examples cover plain text, HTML fragments without html or body wrappers, multiple attachments up to 25MB total, send-as aliases, and draft workflows. Tips note automatic RFC 5322 formatting, MIME encoding, and base64 handling. Because this is a write command, the skill instructs agents to confirm with the user before executing sends. It links to gws-shared for auth and the broader gws-gmail skill for read and manage commands.
- Documents gws gmail +send with required --to, --subject, and --body flags plus optional CC, BCC, and --from alias.
- Supports HTML bodies via --html using fragment tags without full html or body wrappers.
- Allows multiple -a/--attach file attachments with a documented 25MB total size limit.
- Provides --dry-run to preview the request and --draft to save instead of sending immediately.
- Flags this as a write command that requires user confirmation before execution.
Gws Gmail Send by the numbers
- 64,788 all-time installs (skills.sh)
- +2,661 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #19 of 2,742 Automation & Workflows skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
gws-gmail-send capabilities & compatibility
- Capabilities
- gmail send via gws cli · html and plain text body modes · multiple file attachments · cc, bcc, and send as alias support · dry run preview and draft saving
- Use cases
- email · orchestration
What gws-gmail-send says it does
Send an email
Handles RFC 5322 formatting, MIME encoding, and base64 automatically.
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-sendAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 64.8k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
How do I send Gmail from an agent using the gws CLI with correct flags, auth, and safety checks?
Send Gmail messages from the gws CLI with recipients, subject, body, attachments, CC, BCC, HTML, drafts, and dry-run preview.
Who is it for?
Agents automating Gmail sends through the Google Workspace gws CLI with shared auth rules.
Skip if: Skip when you need Gmail read, search, or label management instead of sending messages.
When should I use this skill?
Sending email via gws gmail +send, attaching files, using send-as aliases, saving drafts, or previewing send requests.
What you get
Correctly formatted gws gmail +send commands with RFC 5322 MIME handling and user-confirmed write operations.
- Sent Gmail messages
- Saved drafts
- Dry-run send previews
By the numbers
- Metadata version 0.22.5 in the productivity category.
- Attachment total size limit documented at 25MB.
Files
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!' --draftTips
- 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 — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Related skills
Agent BrowserGive their coding agent reliable, high-fidelity control over any website or Electron desktop app.577k39.1k
Lark ApprovalLet their AI coding agent create, read, update, and approve items in Lark (Feishu) approval workflows without leaving the coding environment.471kLark EventHandle Feishu/Lark bot events, webhooks, and subscription callbacks in agent-driven backend code.471kLark Workflow Meeting SummaryAutomatically generate structured meeting summaries and action items from Lark/Feishu calls without manual note-taking.470kLark Workflow Standup ReportAutomatically generate and post daily standup reports in Lark/Feishu from their workflow and activity data.470kLark Vc AgentGive their coding agent the ability to read, create, and update documents, tasks, and wiki pages inside Feishu (Lark).415kHow it compares
Focused Gmail send command reference, not the full gws Gmail read and manage suite.
FAQ
Who is gws-gmail-send for?
Agents using the Google Workspace gws CLI who need to send Gmail with attachments, HTML, CC, BCC, or drafts.
When should I use gws-gmail-send?
When composing outbound Gmail via gws with --to, --subject, and --body, or when saving drafts and previewing with --dry-run.
Is gws-gmail-send safe to install?
Review the Security Audits panel on this page before installing in production.