{"id":"26eed9f5-762a-489b-a84f-9abb855fae6b","shortId":"Xj45e6","kind":"skill","title":"gws-gmail-send","tagline":"Gmail: Send an email.","description":"# gmail +send\n\n> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.\n\nSend an email\n\n## Usage\n\n```bash\ngws gmail +send --to --subject --body \n```\n\n## Flags\n\n| Flag | Required | Default | Description |\n|------|----------|---------|-------------|\n| `--to` | ✓ | — | Recipient email address(es), comma-separated |\n| `--subject` | ✓ | — | Email subject |\n| `--body` | ✓ | — | Email body (plain text, or HTML with --html) |\n| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |\n| `--attach` | — | — | Attach a file (can be specified multiple times) |\n| `--cc` | — | — | CC email address(es), comma-separated |\n| `--bcc` | — | — | BCC email address(es), comma-separated |\n| `--html` | — | — | Treat --body as HTML content (default is plain text) |\n| `--dry-run` | — | — | Show the request that would be sent without executing it |\n| `--draft` | — | — | Save as draft instead of sending |\n\n## Examples\n\n```bash\ngws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!'\ngws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --cc bob@example.com\ngws gmail +send --to alice@example.com --subject 'Hello' --body 'Bold text' --html\ngws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --from alias@example.com\ngws gmail +send --to alice@example.com --subject 'Report' --body 'See attached' -a report.pdf\ngws gmail +send --to alice@example.com --subject 'Files' --body 'Two files' -a a.pdf -a b.csv\ngws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --draft\n```\n\n## Tips\n\n- Handles RFC 5322 formatting, MIME encoding, and base64 automatically.\n- Use --from to send from a configured send-as alias instead of your primary address.\n- Use -a/--attach to add file attachments. Can be specified multiple times. Total size limit: 25MB.\n- With --html, use fragment tags (

, , ,
, etc.) — no / wrapper needed.\n- Use --draft to save the message as a draft instead of sending it immediately.\n\n> [!CAUTION]\n> This is a **write** command — confirm with the user before executing.\n\n## See Also\n\n- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth\n- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands","tags":["gws","gmail","send","cli","googleworkspace","agent-skills","ai-agent","automation","discovery-api","gemini-cli-extension","google-admin","google-api"],"capabilities":["skill","source-googleworkspace","skill-gws-gmail-send","topic-agent-skills","topic-ai-agent","topic-automation","topic-cli","topic-discovery-api","topic-gemini-cli-extension","topic-google-admin","topic-google-api","topic-google-calendar","topic-google-chat","topic-google-docs","topic-google-drive"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/googleworkspace/cli/gws-gmail-send","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add googleworkspace/cli","source_repo":"https://github.com/googleworkspace/cli","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 26371 github stars · SKILL.md body (2,363 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:30.267Z","embedding":null,"createdAt":"2026-04-18T20:24:30.181Z","updatedAt":"2026-05-18T18:52:30.267Z","lastSeenAt":"2026-05-18T18:52:30.267Z","tsv":"'/alias':74 '/gws-gmail/skill.md':306 '/gws-shared/skill.md':13,298 '25mb':257 '5322':219 'a.pdf':203 'account':78 'add':246 'address':50,69,92,100,241 'alia':236 'alias@example.com':179 'alic':146 'alice@example.com':141,151,162,173,184,196,210 'also':294 'attach':80,81,189,244,248 'auth':15,302 'automat':225 'b.csv':205 'base64':224 'bash':35,136 'bcc':97,98 'bob@example.com':157 'bodi':41,58,60,107,144,154,165,176,187,199,213 'bold':166 'caution':281 'cc':89,90,156 'comma':53,95,103 'comma-separ':52,94,102 'command':286,313 'configur':232 'confirm':287 'content':110 'creat':29 'default':45,79,111 'descript':46 'draft':128,131,215,268,275 'dri':116 'dry-run':115 'email':8,33,49,56,59,91,99,312 'encod':222 'es':51,93,101 'etc':263 'exampl':135 'execut':126,292 'file':83,198,201,247 'flag':17,42,43,300 'format':220 'fragment':261 'generat':26 'generate-skil':25 'global':16,299 'gmail':3,5,9,37,138,148,159,170,181,193,207,305 'gws':2,24,36,137,147,158,169,180,192,206,296,304 'gws-gmail':303 'gws-gmail-send':1 'gws-share':295 'handl':217 'hello':143,153,164,175,212 'hi':145,155,177,214 'html':64,66,105,109,168,259 'immedi':280 'instead':132,237,276 'limit':256 'manag':311 'messag':272 'mime':221 'miss':22 'multipl':87,252 'need':266 'omit':75 'plain':61,113 'prerequisit':11 'primari':240 'read':12,309 'recipi':48 'report':186 'report.pdf':191 'request':120 'requir':44 'rfc':218 'rule':20 'run':23,117 'save':129,270 'secur':19 'see':188,293 'send':4,6,10,31,38,72,134,139,149,160,171,182,194,208,229,234,278,308 'send-a':71,233 'sender':68 'sent':124 'separ':54,96,104 'share':297 'show':118 'size':255 'skill':27 'skill-gws-gmail-send' 'source-googleworkspace' 'specifi':86,251 'subject':40,55,57,142,152,163,174,185,197,211 'tag':262 'text':62,114,167 'time':88,253 'tip':216 'topic-agent-skills' 'topic-ai-agent' 'topic-automation' 'topic-cli' 'topic-discovery-api' 'topic-gemini-cli-extension' 'topic-google-admin' 'topic-google-api' 'topic-google-calendar' 'topic-google-chat' 'topic-google-docs' 'topic-google-drive' 'total':254 'treat':106 'two':200 'usag':34 'use':77,226,242,260,267 'user':290 'without':125 'would':122 'wrapper':265 'write':285","prices":[{"id":"8a632f0d-529d-4292-b57a-c00e51a8d6d2","listingId":"26eed9f5-762a-489b-a84f-9abb855fae6b","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"googleworkspace","category":"cli","install_from":"skills.sh"},"createdAt":"2026-04-18T20:24:30.181Z"}],"sources":[{"listingId":"26eed9f5-762a-489b-a84f-9abb855fae6b","source":"github","sourceId":"googleworkspace/cli/gws-gmail-send","sourceUrl":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-send","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:56.792Z","lastSeenAt":"2026-05-18T18:52:30.267Z"},{"listingId":"26eed9f5-762a-489b-a84f-9abb855fae6b","source":"skills_sh","sourceId":"googleworkspace/cli/gws-gmail-send","sourceUrl":"https://skills.sh/googleworkspace/cli/gws-gmail-send","isPrimary":true,"firstSeenAt":"2026-04-18T20:24:30.181Z","lastSeenAt":"2026-05-07T22:40:14.623Z"}],"details":{"listingId":"26eed9f5-762a-489b-a84f-9abb855fae6b","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"googleworkspace","slug":"gws-gmail-send","github":{"repo":"googleworkspace/cli","stars":26371,"topics":["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"],"license":"apache-2.0","html_url":"https://github.com/googleworkspace/cli","pushed_at":"2026-05-12T16:46:11Z","description":"Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.","skill_md_sha":"55da9c28cc771c4ad32f67f6ac8799fcde3e48c3","skill_md_path":"skills/gws-gmail-send/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-send"},"layout":"multi","source":"github","category":"cli","frontmatter":{"name":"gws-gmail-send","description":"Gmail: Send an email."},"skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-gmail-send"},"updatedAt":"2026-05-18T18:52:30.267Z"}}