gws-gmail-send
Send Gmail Emails via CLI
Send emails programmatically through Gmail without leaving your terminal. This skill integrates Claude Code with the Google Workspace CLI to send emails with attachments, HTML formatting, and advanced options.
Download the skill ZIP
Upload in Claude
Go to Settings → Capabilities → Skills → Upload skill
Toggle on and start using
Test it
Using "gws-gmail-send". Send an email to alice@example.com with subject 'Hello' and body 'Hi Alice!'
Expected outcome:
Email sent successfully to alice@example.com with subject 'Hello'
Using "gws-gmail-send". Send an email with attachment to team@company.com with subject 'Report' and attach report.pdf
Expected outcome:
Email sent successfully to team@company.com with subject 'Report' and 1 attachment (report.pdf)
Using "gws-gmail-send". Save as draft: email to bob@example.com, subject 'Draft', body 'Testing'
Expected outcome:
Draft saved successfully for bob@example.com with subject 'Draft'
Security Audit
SafeAll 20 static analysis findings are false positives from Markdown code examples. The external_commands flags (15 occurrences) are bash documentation blocks showing gws CLI usage. The filesystem flags (3 occurrences) are relative path references in documentation links. This is legitimate documentation for a Gmail CLI tool with no executable code or security risks.
Risk Factors
⚙️ External commands (4)
📁 Filesystem access (2)
Quality Score
What You Can Build
Automated Email Notifications
Send automated notifications from scripts or CI/CD pipelines when deployment completes or tests fail.
Batch Email Sending
Send personalized emails to multiple recipients by combining Claude Code with CSV data and the gws CLI.
Report Distribution
Attach and send generated reports (PDFs, CSVs) to stakeholders automatically on a schedule.
Try These Prompts
Send an email to alice@example.com with subject 'Project Update' and body 'The project is complete.'
Send an email to team@company.com with subject 'Monthly Report' and body 'Please find attached the report.' Attach the file report.pdf
Send an HTML email to users@example.com with subject 'Newsletter' and body '<p>Welcome to our newsletter!</p><br><b>Feature highlights:</b><br>- New dashboard<br>- Faster performance'
Send from alias@company.com to client@example.com with subject 'Proposal' and body 'Please review our proposal.' CC manager@company.com and BCC archives@company.com
Best Practices
- Always confirm with the user before executing send commands as this is a write operation that sends real emails
- Use the --dry-run flag first to preview the request that will be sent without actually sending the email
- Combine with --draft flag to save emails as drafts first for review before sending to recipients
Avoid
- Do not send emails without explicit user confirmation due to the irreversible nature of email transmission
- Avoid exceeding the 25MB attachment limit as larger attachments will cause the send operation to fail
- Do not use full HTML document structure with <html> or <body> tags when using the --html flag