# Gws Gmail Send > gmail +send - Skill: `wimpysworld/gws-gmail-send` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add wimpysworld/gws-gmail-send` - Raw SKILL.md: https://api.skillmd.com/api/skills/wimpysworld/gws-gmail-send/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: wimpysworld (https://skillmd.com/u/wimpysworld) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/wimpysworld/gws-gmail-send --- # gmail +send > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, stop and repair the declarative skill deployment. Send an email ## Usage ```bash gws gmail +send --to --subject --body ``` ## 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 ```bash 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 'Bold 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!' --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 (

, , ,
, 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](../gws-shared/SKILL.md) — Global flags and auth - [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands