Gws Gmail Send

Gmail: Send an email.

Security Scan

The skill is internally consistent: it is an instruction-only wrapper that expects a 'gws' CLI to send Gmail messages and does not request unrelated credentials or installs.

Purpose & Capability

Name/description (Gmail send) match the required binary ('gws') and the SKILL.md usage examples. Requiring the 'gws' CLI is appropriate for a CLI-based Gmail send helper.

Instruction Scope

The SKILL.md is narrowly scoped to building and running 'gws gmail +send' and documents flags, attachments, and dry-run. It does instruct the agent to read '../gws-shared/SKILL.md' for auth, global flags, and security rules — that external reference means the agent may attempt to read sibling skill files or run 'gws generate-skills' if missing. Reading that shared file is reasonable for auth guidance, but you should verify what the referenced file requires before granting access.

Install Mechanism

No install spec is present (instruction-only). Nothing is downloaded or written by the skill itself; it simply invokes an existing 'gws' binary on PATH.

Credentials

This skill declares no required environment variables, which is consistent with being a thin wrapper. However, authentication and global flags are delegated to gws-shared (external), which likely requires credentials or tokens; inspect gws-shared/SKILL.md or your gws configuration to confirm what secrets (OAuth tokens, account credentials) are used and where they are stored.

Persistence & Privilege

always is false and the skill is user-invocable. It does not request persistent system-wide privileges in its own metadata. The runtime will execute the 'gws' CLI as the agent; any persistence depends on that CLI, not this skill.

Assessment

This skill is a thin instruction-only wrapper around the 'gws' command-line tool for sending Gmail messages. Before installing or enabling it: (1) verify you trust the 'gws' binary on your system (check its source and how it stores credentials); (2) open the referenced ../gws-shared/SKILL.md to see what auth or tokens are required and where they are stored; (3) prefer --dry-run first to inspect the request the tool would make; (4) be cautious when allowing the agent to read files you might attach (attachments read from disk are expected behavior); and (5) confirm with users before any write/send action as the SKILL.md itself recommends.

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

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 [e-mail] --subject 'Hello' --body 'Hi Alice!'
gws gmail +send --to [e-mail] --subject 'Hello' --body 'Hi!' --cc [e-mail]
gws gmail +send --to [e-mail] --subject 'Hello' --body '<b>Bold</b> text' --html
gws gmail +send --to [e-mail] --subject 'Hello' --body 'Hi!' --from [e-mail]
gws gmail +send --to [e-mail] --subject 'Report' --body 'See attached' -a report.pdf
gws gmail +send --to [e-mail] --subject 'Files' --body 'Two files' -a a.pdf -a b.csv
gws gmail +send --to [e-mail] --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 (<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 — Global flags and auth
• gws-gmail — All send, read, and manage email commands