Labsco
googleworkspace logo

gws-gmail-send

✓ Official★ 29,400

by Google · part of googleworkspace/cli

Gmail: Send an email.

🔥🔥✓ VerifiedFreeQuick setup
#email#automation#documents#git#security
🧰 Not standalone. This skill ships with googleworkspace/cli and only works together with that tool — install the tool first, then add this skill.

Gmail: Send an email.

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by Google

Gmail: Send an email. npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-send** Download ZIPGitHub29.4k

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

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

Copy & paste — that's it
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi Alice!'
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi!' --cc [email protected]
gws gmail +send --to [email protected] --subject 'Hello' --body ' Bold** text' --html
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi!' --from [email protected]
gws gmail +send --to [email protected] --subject 'Report' --body 'See attached' -a report.pdf
gws gmail +send --to [email protected] --subject 'Files' --body 'Two files' -a a.pdf -a b.csv
gws gmail +send --to [email protected] --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

**