# Gws Gmail Send > Gmail: Send an email. Source: https://skillsagentes.com/skills/googleworkspace/cli/gws-gmail-send Repository: https://github.com/googleworkspace/cli Author: googleworkspace License: Apache-2.0 Updated: hace 4 meses Context cost: 5 tok installed, 657 tok once triggered, 657 tok with every bundled file Bundle: 1 file, 3 KB Permissions requested: none declared ## Install ```bash npx -y skills add googleworkspace/cli --skill gws-gmail-send --agent claude-code ``` ## What it does - Envía un correo Gmail mediante `gws gmail +send --to --subject --body ` - Permite adjuntar archivos con -a/--attach (hasta 25MB total), usar CC/BCC y enviar como HTML con --html - Puede guardar el mensaje como borrador con --draft en vez de enviarlo - Soporta enviar desde un alias configurado con --from y previsualizar con --dry-run ## Use it when - Se necesita enviar un correo desde la línea de comandos con gws - Se requiere adjuntar archivos, usar CC/BCC, HTML o enviar desde un alias - Se quiere guardar un correo como borrador en lugar de enviarlo de inmediato ## What triggers it - "Envía un correo a alice@example.com con el asunto 'Hello' y el cuerpo 'Hi Alice!'" - "Manda un correo con el reporte report.pdf adjunto a alice@example.com" - "Guarda como borrador un correo HTML para alice@example.com" ## Before you install - Requiere el binario `gws` y haber leído ../gws-shared/SKILL.md para autenticación, flags globales y reglas de seguridad. ## Files - SKILL.md — 3 KB ## SKILL.md Reproduced verbatim from googleworkspace/cli under Apache-2.0. This section is the upstream document and is in English. # 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 --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 --- Skills Agentes — https://skillsagentes.com/skills/googleworkspace/cli/gws-gmail-send