# Gws Gmail Send

> Sends an email through the Gmail API using the gws CLI, with optional CC, BCC, HTML body, file attac

Sends an email through the Gmail API using the gws CLI, with optional CC, BCC, HTML body, file attachments up to 25MB, a send-as alias sender, or saving as a draft. Use when the user asks to send, email, or draft a message via Gmail from the command line, after confirming the recipients and content with the user.

- Page: https://ss33.ai/skills/streakyc/gws-gmail-send-37830303484
- Publisher: streakyc
- Category: [Business](https://ss33.ai/skills/category/business-y1h0vy) › [Operations & productivity](https://ss33.ai/skills/category/business-y1h0vy/operations-and-productivity-ivsf8j)
- License: Apache-2.0
- Source: https://github.com/streakyc/googleworkspacecli/blob/0dbb74c2cd4db7216b1c7fae73f7c9a30ffe9ddd/skills/gws-gmail-send/SKILL.md

## Skill

SKILL.md: https://ss33.ai/api/v1/ss33/download/streakyc/gws-gmail-send-37830303484

# 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

```bash
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, used verbatim (plain text, or HTML with --html). \n is NOT a newline — use $'...' or a real line break |
| `--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 '<b>Bold</b> 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
# Multi-line body — $'...' quoting turns \n into a real newline:
gws gmail +send --to alice@example.com --subject 'Update' --body $'Hi Alice,\n\nShipped today.\n\nBlake'
# Long body — read it from a file instead of quoting inline:
gws gmail +send --to alice@example.com --subject 'Update' --body "$(cat body.txt)"
```

## Tips

- IMPORTANT: --body is verbatim. Writing --body "Hi,\n\nThanks" sends a literal backslash-n to the recipient; it does NOT create a line break. Use $'Hi,\n\nThanks' or "$(cat file.txt)". See gws-shared Shell 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