gws-gmail-send
Gmail: Send an email.
pinned to #a3768d0updated 2 days ago
Ask your AI client: “install skills/gws-gmail-send”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/gws-gmail-sendmetahub onboarded this repo on the author's behalf.
If you own github.com/googleworkspace/cli on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
30,273
Last commit
2 days ago
Latest release
published
- #agent-skills
- #ai-agent
- #automation
- #cli
- #discovery-api
- #gemini-cli-extension
- #google-admin
- #google-api
- #google-calendar
- #google-chat
- #google-docs
- #google-drive
- #google-sheets
- #google-workspace
- #oauth2
- #rust
About this skill
Pulled from SKILL.md at publish time.
PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.a3768d0· 2 days ago
Documentation
6 passed3 warningsDescription qualitywarn
Only 4 words · 21 chars — below the 15-word bar, listed anyway as an official artifact
A skill's description doubles as its trigger. Describe what it does, when to use it, what file types it handles.
Description is substantivewarn
Description is 4 words — thinner than the 8-word floor.
Say what it does AND when to use it. A model choosing between tools has only this text to go on.
Homepage or repository declaredwarn
No homepage or repository declared.
Add a "homepage" or "repository" field to SKILL.md.
README is present and substantial
20,235 chars · 16 sections · 22 code blocks
Tags / topics declared
16 total — agent-skills, ai-agent, automation, cli, discovery-api, gemini-cli-extension (+10)
README has usage / example sections
found: Installation · Quick Start
Homepage / docs URL declared
https://developers.google.com/workspace
Documentation present and substantive
Documentation present (SKILL.md, 410 words).
Documentation shows usage
Documentation includes 2 code examples.
Release history
1- releasecurrenta3768d0warn2 days ago
Contents
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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 (, <b>, <a>, , 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 — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Reviews
No reviews yet. Be the first.
Related
Verification Before Completion
Evidence before assertions, always
Writing Plans
Turn specs into phased implementation plans
Test-Driven Development
Red → green → refactor discipline for any feature or bugfix
mh install skills/gws-gmail-send