gws-gmail-send skill
Gmail: Send an email.
A100/100content scan
Is the gws-gmail-send skill safe?
Clean: nothing in its files matched our rules. We read 1 file in the folder on 2026-09-28.
No findings.
Install the gws-gmail-send skill
A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description.
git clone --depth 1 https://github.com/googleworkspace/cli.git /tmp/cli mkdir -p ~/.claude/skills cp -r /tmp/cli/skills/gws-gmail-send ~/.claude/skills/gws-gmail-send
available in every project
In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub
The instructions your agent would load
SKILL.md as published, without the frontmatter. Read it on 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 <EMAILS> --subject <SUBJECT> --body <TEXT>Flags
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!' --draftTips
- 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
More skills from googleworkspace/cli
- Agws-admin-reportsGoogle Workspace Admin SDK: Audit logs and usage reports.
- Agws-calendarGoogle Calendar: Manage calendars and events.
- Agws-calendar-agendaGoogle Calendar: Show upcoming events across all calendars.
- Agws-calendar-insertGoogle Calendar: Create a new event.
- Agws-chatGoogle Chat: Manage Chat spaces and messages.
- Agws-chat-sendGoogle Chat: Send a message to a space.
- Agws-classroomGoogle Classroom: Manage classes, rosters, and coursework.
- Agws-docsRead and write Google Docs.
- Agws-docs-writeGoogle Docs: Append text to a document.
- Agws-driveGoogle Drive: Manage files, folders, and shared drives.
- Agws-drive-uploadGoogle Drive: Upload a file with automatic metadata.
- Agws-eventsSubscribe to Google Workspace events.