← Back to Skills Marketplace
Gws Gmail Send
by
googleworkspace-bot
· GitHub ↗
· v1.0.15
· MIT-0
1172
Downloads
0
Stars
18
Active Installs
16
Versions
Install in OpenClaw
/install gws-gmail-send
Description
Gmail: Send an email.
README (SKILL.md)
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 \x3CEMAILS> --subject \x3CSUBJECT> --body \x3CTEXT>
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 '\x3Cb>Bold\x3C/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!' --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 (\x3Cp>, \x3Cb>, \x3Ca>, \x3Cbr>, etc.) — no \x3Chtml>/\x3Cbody> 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
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: gws-gmail-send
Version: 1.0.15
The skill 'gws-gmail-send' provides a standard interface for sending emails via the 'gws' CLI tool. It includes appropriate safety warnings in SKILL.md, such as requiring user confirmation for write operations, and lacks any indicators of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-gmail-send - After installation, invoke the skill by name or use
/gws-gmail-send - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.15
- Updated version metadata from 0.22.4 to 0.22.5 in SKILL.md.
- No changes to functionality or usage; documentation only.
v1.0.14
- Updated skill metadata version to 0.22.4
- No functional or documentation changes; version bump only
v1.0.13
- Updated version number in metadata from 0.22.2 to 0.22.3 in SKILL.md.
- No changes to functionality or documentation content.
v1.0.12
- Updated version metadata from 0.22.1 to 0.22.2 in SKILL.md.
- No functional or usage changes; documentation update only.
v1.0.11
- Updated skill metadata version from 0.22.0 to 0.22.1 in SKILL.md.
v1.0.10
- Updated version number in SKILL.md to 0.22.0.
- No changes to functionality or usage; documentation version increment only.
v1.0.9
- Added --draft flag to allow saving emails as drafts instead of sending immediately
- Updated usage examples and tips to document draft-saving functionality
- Bumped metadata version to 0.21.2
v1.0.8
- Updated skill metadata version to 0.21.1.
- No changes to features, usage, or flags; documentation version increment only.
v1.0.7
- Updated version in metadata from 0.20.0 to 0.20.1.
- No functional or documentation changes beyond the internal version bump.
v1.0.6
- Updated metadata version from 0.19.0 to 0.20.0 in SKILL.md.
- No functional or usage changes; only documentation version update.
v1.0.5
- Updated SKILL.md metadata: moved version number to the metadata block and removed the top-level version field.
- Set version to 0.19.0 in metadata.
- No changes to command usage, flags, or function.
- Documentation is now more consistent with other skills.
v1.0.4
- Documentation formatting adjustments in SKILL.md for clarity and consistency.
- No changes to functionality or usage.
v1.0.3
- Removed the --attachment flag from the documented options; only --attach is now listed for file attachments.
- Minor cleanup of the Flags table to reflect supported parameters.
- No changes to usage, examples, or functionality documented besides flag clarification.
v1.0.2
- Added --from flag to specify sender address (for send-as/alias support).
- Added --attach / -a flags for including one or more email attachments (up to 25MB total).
- Updated documentation to reflect attachment usage and new flags.
- Clarified tips on MIME and HTML usage.
v1.0.1
- Added support for comma-separated multiple recipients in --to, --cc, and --bcc flags.
- Introduced --cc and --bcc flags for sending emails with CC and BCC recipients.
- Added --html flag to send HTML-formatted emails.
- Added --dry-run flag to preview the request without sending an email.
- Updated examples and flag descriptions to reflect new features.
v1.0.0
Initial release of gws-gmail-send.
- Enables sending emails via Gmail from the command line.
- Supports required flags: --to, --subject, and --body for simple plain-text messages.
- Automatically formats according to RFC 2822 and encodes message as needed.
- For advanced use (HTML, attachments, CC/BCC), recommends using the raw API.
- Integrates with gws authentication and shared configuration.
Metadata
Frequently Asked Questions
What is Gws Gmail Send?
Gmail: Send an email. It is an AI Agent Skill for Claude Code / OpenClaw, with 1172 downloads so far.
How do I install Gws Gmail Send?
Run "/install gws-gmail-send" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Gmail Send free?
Yes, Gws Gmail Send is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Gmail Send support?
Gws Gmail Send is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Gmail Send?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.15.
More Skills