Initial commit

commands/mail-send.md

@@ -0,0 +1,45 @@
+---
+description: Send email via Gmail API
+argument-hint: to subject body
+---
+
+Send an email message via Gmail.
+
+## Usage
+
+```bash
+google-gmail-tool mail send --to "EMAIL" --subject "SUBJECT" --body "BODY"
+```
+
+## Arguments
+
+- `--to EMAIL`: Recipient email (required)
+- `--subject TEXT`: Email subject (required)
+- `--body TEXT`: Email body (required)
+- `--cc EMAIL`: CC recipients (optional)
+- `--bcc EMAIL`: BCC recipients (optional)
+- `--html`: Send as HTML instead of plain text
+- `--dry-run`: Preview without sending
+- `-v/-vv/-vvv`: Verbosity (INFO/DEBUG/TRACE)
+
+## Examples
+
+```bash
+# Send plain text email
+google-gmail-tool mail send \
+    --to "user@example.com" \
+    --subject "Meeting Notes" \
+    --body "Here are the notes..."
+
+# Send HTML email with CC
+google-gmail-tool mail send \
+    --to "user@example.com" \
+    --cc "team@example.com" \
+    --subject "Report" \
+    --body "<h1>Report</h1>" \
+    --html
+```
+
+## Output
+
+Returns success confirmation with message ID.