SkillsAdd

googleworkspace/cli · Official

gws-gmail-send

Gmail: Send an email.

All-time #395 Trending #1125 Hot #5939 First seen Mar 4, 2026
8-week activity · all time api

Installation

$ npx skills add googleworkspace/cli --skill gws-gmail-send
View on skills.sh ↗ GitHub repository ↗

Summary

  • Send emails via Gmail with support for attachments, HTML formatting, and send-as aliases.
  • Requires recipient email(s), subject, and body text; supports CC, BCC, and optional sender address for send-as aliases Handles file attachments up to 25MB total, with multiple files supported via repeated --attach flags Supports both plain text and HTML email bodies; HTML fragments do not require wrapper tags Includes --dry-run flag to preview the request before sending, and automatic RFC 5322 formatting and MIME encoding

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

gmail-workflows Similar name
claude-office-skills/skills

Automate Gmail with intelligent workflows - attachment management, email organization, auto-arc…

4.3K installs
gmail-skill Similar name
idanbeck/claude-skills

Read, search, send, and draft Gmail emails and Google contacts. Use when the user asks to check…

3.5K installs
gmail Similar name
membranedev/application-skills

Gmail integration. Manage communication data, records, and workflows. Use when the user wants t…

779 installs
gws-gmail Similar name
streakyc/googleworkspacecli

Gmail: Send, read, and manage email.

25 installs
gws-gmail-send Similar name
streakyc/googleworkspacecli

Gmail: Send an email.

25 installs
gws-gmail-reply Similar name
streakyc/googleworkspacecli

Gmail: Reply to a message (handles threading automatically).

25 installs

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Apr 1, 2026

The skill enables the agent to send emails and attachments using the 'gws' CLI tool. All identified behaviors are consistent with its stated purpose of Gmail automation.

snyk LOW

Analyzed Apr 1, 2026

No issues detected.

socket Score 0.9000 · 0 alerts

Analyzed Apr 1, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli
gws-gmail 74.7K gws-drive 68K gws-shared 59.4K gws-calendar 55.1K gws-sheets 52.5K gws-docs 52K gws-sheets-read 45.1K gws-docs-write 44.6K gws-calendar-agenda 44.2K gws-drive-upload 43.9K

Browse all from googleworkspace/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 30.8K
License LICENSE
Default branch main
Open issues 129
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws gmail +send --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,626 B
  • docs SUMMARY.md 43 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 69,600 installs

SKILL.md

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

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

Examples

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

Tips

  • 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.

[!CAUTION]
This is a write command — confirm with the user before executing.

See Also

  • [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
  • [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands