gws-gmail-sendby Google

Gmail: Send an email.

npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-send

Download ZIP GitHub

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 <EMAIL> --subject <SUBJECT> --body <TEXT>

Flags

Flag	Required	Default	Description
`--to`	✓	—	Recipient email address
`--subject`	✓	—	Email subject
`--body`	✓	—	Email body (plain text)

Examples

gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!'

Tips

Handles RFC 2822 formatting and base64 encoding automatically.
For HTML bodies, attachments, or CC/BCC, use the raw API instead:
gws gmail users messages send --json '...'

[!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

More skills from Google

gws-groupssettings

Manage Google Groups settings.

gws-modelarmor-sanitize-response

Google Model Armor: Sanitize a model response through a Model Armor template.

Google People: Manage contacts and profiles.

Google Workspace Reseller: Manage Workspace subscriptions.

gws CLI: Shared patterns for authentication, global flags, and output formatting.

Google Sheets: Read and write spreadsheets.

gws-sheets-append

Google Sheets: Append a row to a spreadsheet.

gws-sheets-read

Google Sheets: Read values from a spreadsheet.