gws-gmail-send
Gmail: Send an email.
By streakyc · 781 installs
npx skills add streakyc/googleworkspacecli --skill gws-gmail-send
Source repository · Upstream listing
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
Flags
Flag Required Default Description
to ✓ — Recipient email address(es), comma separated
subject ✓ — Email subject
body ✓ — Email body, used verbatim (plain text, or HTML with html). \n is NOT a newline — use $'...' or a real line break
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
Tips
IMPORTANT: body is verbatim. Writing body "Hi,\n\nThanks" sends a literal backslash n to the recipient; it does NOT create a line break. Use $'Hi,\n\nThanks' or "$(cat file.txt)". See gws shared Shell 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