Gws Gmail Send
Google WorkspaceOfficialPublished by Google Workspace
- Skill
- Tool integration
- Automation and integrations
- Apache-2.0
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
The gws-gmail-send skill provides a direct interface to the Gmail API for sending emails from the command line. It supports standard email features including CC, BCC, file attachments, and HTML formatting. The tool handles complex MIME encoding and base64 conversion automatically, allowing users to send messages or save them as drafts directly from their terminal.
What it does
- Sends emails to one or more recipients via Gmail.
- Supports CC and BCC fields for message distribution.
- Allows sending plain text or HTML-formatted email bodies.
- Enables file attachments up to a 25MB total limit.
- Supports sending from configured aliases using the from flag.
- Provides a draft mode to save messages without sending them immediately.
When to use it
- When you need to automate email notifications from a terminal or script.
- When you want to send reports or files as attachments via command line.
- When you need to manage email drafts programmatically.
- When you prefer using a CLI to send emails instead of a web interface.
Advantages
- Automates email workflows directly from the command line.
- Handles complex MIME and base64 encoding automatically.
- Supports multiple attachments in a single command.
- Includes a dry-run feature to verify requests before execution.
Usage examples
- “Send a simple email to [email removed] with the subject Hello and body Hi Alice!”
- The agent executes the command to send a plain text email to the specified recipient.
- “Send an HTML email to [email removed] with bold text.”
- The agent sends an email using the --html flag to render the provided tags correctly.
- “Send an email to [email removed] with a file named report.pdf attached.”
- The agent attaches the specified file and sends the email to the recipient.
- “Save an email to [email removed] as a draft.”
- The agent uses the --draft flag to create a new draft in the user's Gmail account instead of sending it.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/googleworkspace/gws-gmail-send/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip gws-gmail-send.zip -d .agents/skills
Documentation by Google Workspace
gmail +send
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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 [email protected] --subject 'Hello' --body 'Hi Alice!'
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi!' --cc [email protected]
gws gmail +send --to [email protected] --subject 'Hello' --body '<b>Bold</b> text' --html
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi!' --from [email protected]
gws gmail +send --to [email protected] --subject 'Report' --body 'See attached' -a report.pdf
gws gmail +send --to [email protected] --subject 'Files' --body 'Two files' -a a.pdf -a b.csv
gws gmail +send --to [email protected] --subject 'Hello' --body 'Hi!' --draftTips
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
Files
- ATTRIBUTION.mdAdded by AutoGineer890 B
- LICENSELicence file added by AutoGineer11.1 KiB
- SKILL.md2.6 KiB
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Published by
- Google Workspace
- Publisher
- Google Workspace (Official)
- Source
- googleworkspace/cli · skills/gws-gmail-send · commit cd3697e
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Google Workspace or Google Workspace.
Related skills
Build MCP App
AnthropicOfficial
Build interactive UI widgets for MCP servers to render forms, pickers, and dashboards directly within the chat interface.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 moreApache-2.0GitHub stars of the source repository46.3k
MCP Integration
AnthropicOfficial
Comprehensive guide for integrating Model Context Protocol (MCP) servers into Claude Code plugins.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 moreApache-2.0GitHub stars of the source repository46.3k
Social Publishing
Seth Hobson· Community
Programmatically schedule and publish content across 13 social media platforms using the SocialClaw API.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 moreMITGitHub stars of the source repository42.3k
Hermes Tweet
Seth Hobson· Community
Integrates X/Twitter research and action capabilities into the Hermes Agent framework with strict approval-gated security.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 moreMITGitHub stars of the source repository42.3k
Paypal Integration
Seth Hobson· Community
A guide to integrating PayPal payment processing, including checkout flows, subscriptions, and IPN webhook handling.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 moreMITGitHub stars of the source repository42.3k
Social Publishing Publisher
Seth Hobson· Community
An agent-driven social media publishing specialist for multi-platform campaign management via the SocialClaw API.
Automation and integrationsClaude CodeMITGitHub stars of the source repository42.3k
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download gws-gmail-send.zip