CtrlK
BlogDocsLog inGet started
Tessl Logo

gws-gmail-send

Gmail: Send an email.

57

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/gws-gmail-send/SKILL.md
SKILL.md
Quality
Evals
Security

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

FlagRequiredDefaultDescription
--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
Repository
googleworkspace/cli
Path

skills/gws-gmail-send/SKILL.md

Commit

a3768d0

Last updated
First committed

Also appears in

pleaseai/google-workspace
Stale

last in sync Mar 5, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill