🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Gws Gmail Send

by @googleworkspace-bot

Gmail: Send an email.

Versionv1.0.15
Downloads2,188
TERMINAL
clawhub install gws-gmail-send

πŸ“– About This Skill


name: gws-gmail-send description: "Gmail: Send an email." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws gmail +send --help"

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  --subject  --body 

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 'Bold 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
  • πŸ’‘ 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 'Bold 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 & Best Practices

  • 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.