gws-gmail-send

Send emails via Gmail with support for attachments, HTML formatting, and send-as aliases.

googleworkspace ↓ 64k
Claude Code
View source ↗

What it does

  • 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.
  • gws-shared — Global flags and auth
  • gws-gmail — All send, read, and manage email commands

Requirements & configuration

  • PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Send emails via Gmail with support for attachments, HTML formatting, and send-as aliases.

Source

Repository: https://github.com/googleworkspace/cli

gws-gmail-send FAQ

What does the gws-gmail-send skill do?

Gmail: Send an email. Handles RFC 5322 formatting, MIME encoding, and base64 automatically. Use --from to send from a configured send-as alias instead of your primary address.

What does gws-gmail-send require?

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

How do I install gws-gmail-send?

Run: npx -y skills add https://github.com/googleworkspace/cli --skill gws-gmail-send --agent claude-code — the source lives at github.com/googleworkspace/cli.

Maintain gws-gmail-send?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

gws-gmail-send on getagentictools
[![gws-gmail-send on getagentictools](https://getagentictools.com/badge/skills/googleworkspace-cli-gws-gmail-send.svg)](https://getagentictools.com/skills/googleworkspace-cli-gws-gmail-send?ref=badge)
npx agentictools info skills/googleworkspace-cli-gws-gmail-send

The second line is the CLI lookup for this page — handy in READMEs and docs.