googleworkspace avatar

Gws Gmail Send

A straightforward Gmail sending tool that handles the messy parts of email composition for you. Automatically deals with RFC 5322 formatting, MIME encoding, and base64 attachment handling so you don't have to think about it. Supports the usual suspects like CC/BCC, HTML content, file attachments up to 25MB, and sending from aliases. The draft mode is handy for preparing emails programmatically without firing them off immediately. It's a write command so Claude will ask before executing, which is exactly what you want when dealing with email.

skills.sh installs
76.1K
GitHub stars
32.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add googleworkspace/cli --skill gws-gmail-send --agent claude-code

Installs into .claude/skills of the current project.

Files

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

FlagRequiredDefaultDescription
--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

Sponsors

Details

Repository
github.com/googleworkspace/cli
Categories
CLI & Terminal, Office & Documents

More from googleworkspace/cli

All 113
1firecrawl avatarfirecrawl-interactfirecrawl/cliControl and interact with a live browser session on any scraped page — click buttons, fill forms, navigate flows, and extract data using natural language prompt65.6Kskills.sh installs
2larksuite avatarlark-meetinglarksuite/cli飞书视频会议:查询会议记录与会议产物(纪要/逐字稿/妙记)、妙记搜索/上传/下载/编辑、机器人参与会议;查询进行中的会议、实时会议内容(发言/聊天/共享文档)问答(会上/会里)、发送会中聊天/表情;基于 meeting_id、meeting_no、event_id、note_id、minute_token、vc-nod65.4Kskills.sh installs
3googleworkspace avatargws-calendargoogleworkspace/cliGoogle Calendar: Manage calendars and events.62.9Kskills.sh installs
4googleworkspace avatargws-sheetsgoogleworkspace/cliGoogle Sheets: Read and write spreadsheets.60.7Kskills.sh installs
5googleworkspace avatargws-sheets-readgoogleworkspace/cliGoogle Sheets: Read values from a spreadsheet.52Kskills.sh installs
6googleworkspace avatargws-docs-writegoogleworkspace/cliGoogle Docs: Append text to a document.51.5Kskills.sh installs