googleworkspace/gws-gmail-send
Gmail: Send an email.
npx skills add https://github.com/googleworkspace/cli --skill gws-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
gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT>
| 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 |
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 '<b>Bold</b> 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
> [!CAUTION]
> This is a write command — confirm with the user before executing.
Take googleworkspace/gws-gmail-send from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.