← Back to Skills Marketplace
Gws Gmail Forward
by
googleworkspace-bot
· GitHub ↗
· v1.0.14
· MIT-0
460
Downloads
0
Stars
7
Active Installs
15
Versions
Install in OpenClaw
/install gws-gmail-forward
Description
Gmail: Forward a message to new recipients.
README (SKILL.md)
gmail +forward
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Forward a message to new recipients
Usage
gws gmail +forward --message-id \x3CID> --to \x3CEMAILS>
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--message-id |
✓ | — | Gmail message ID to forward |
--to |
✓ | — | Recipient email address(es), comma-separated |
--from |
— | — | Sender address (for send-as/alias; omit to use account default) |
--body |
— | — | Optional note to include above the forwarded message (plain text, or HTML with --html) |
--no-original-attachments |
— | — | Do not include file attachments from the original message (inline images in --html mode are preserved) |
--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 +forward --message-id 18f1a2b3c4d --to [email protected]
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --body 'FYI see below'
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --cc [email protected]
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --body '\x3Cp>FYI\x3C/p>' --html
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] -a notes.pdf
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --no-original-attachments
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --draft
Tips
- Includes the original message with sender, date, subject, and recipients.
- Original attachments are included by default (matching Gmail web behavior).
- With --html, inline images are also preserved via cid: references.
- In plain-text mode, inline images are not included (matching Gmail web).
- Use --no-original-attachments to forward without the original message's files.
- Use -a/--attach to add extra file attachments. Can be specified multiple times.
- Combined size of original and user attachments is limited to 25MB.
- With --html, the forwarded block uses Gmail's gmail_quote CSS classes and preserves HTML formatting. Use fragment tags (\x3Cp>, \x3Cb>, \x3Ca>, etc.) — no \x3Chtml>/\x3Cbody> wrapper needed.
- Use --draft to save the forward as a draft instead of sending it immediately.
See Also
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Usage Guidance
This skill appears to be a thin wrapper around the gws CLI and is coherent with its purpose, but before installing: (1) verify the provenance and integrity of the gws binary you will run (trusted source, expected version); (2) open and review ../gws-shared/SKILL.md (or the gws auth docs) to see what credentials or tokens it requires and how they are stored; (3) test with --dry-run and --draft to confirm behavior; and (4) be aware that forwarding will send full message content and attachments to whatever recipients you specify, so confirm recipient addresses and organizational policy before use.
Capability Analysis
Type: OpenClaw Skill
Name: gws-gmail-forward
Version: 1.0.14
The skill bundle provides documentation for forwarding Gmail messages using the 'gws' CLI tool. The SKILL.md file defines standard email parameters (to, cc, bcc, body, attachments) and lacks any indicators of malicious intent, prompt injection, or unauthorized data access.
Capability Assessment
Purpose & Capability
The name/description (Gmail forward) match the runtime instructions which call the gws CLI. Requiring the gws binary is expected for a CLI-wrapper skill and there are no unrelated binaries or environment variables requested.
Instruction Scope
SKILL.md only documents using gws gmail +forward with well-scoped flags. The file points the operator to ../gws-shared/SKILL.md for auth/global flags, which is relevant to executing Gmail actions; the skill does not itself instruct reading arbitrary unrelated system files or exfiltrating data.
Install Mechanism
No install spec or archive downloads are present (instruction-only skill). Nothing is written to disk by the skill itself during install.
Credentials
The skill declares no env vars or credentials itself, but it delegates auth and global flags to gws/gws-shared. That means actual credential access and storage are handled outside this SKILL.md (in the gws binary or gws-shared configuration). You should review those artifacts to confirm what credentials/config they require and how they are stored.
Persistence & Privilege
always is false and the skill is user-invocable only. It does not request persistent platform privileges or modify other skills' configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-gmail-forward - After installation, invoke the skill by name or use
/gws-gmail-forward - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.14
- Updated version number in SKILL.md metadata from 0.22.4 to 0.22.5.
- No functional or documentation changes to usage, flags, examples, or tips.
v1.0.13
- Updated skill metadata version from 0.22.3 to 0.22.4 in SKILL.md.
- No changes to commands, flags, usage, or feature set.
- Documentation update only.
v1.0.12
- Updated the documented version in SKILL.md from 0.22.2 to 0.22.3.
- No changes to functionality or usage—documentation update only.
v1.0.11
- Updated version number in SKILL.md metadata from 0.22.1 to 0.22.2.
v1.0.10
- Updated version metadata from 0.22.0 to 0.22.1 in SKILL.md.
- No functional or behavioral changes; documentation update only.
v1.0.9
- Version updated to 0.22.0 in SKILL.md
- No functional or usage changes; documentation version number increment only
v1.0.8
- Added --draft flag to allow saving forwarded emails as drafts instead of sending immediately
- Updated examples and tips to demonstrate and explain the new draft option
- Incremented skill version in metadata
v1.0.7
- Updated version from 0.20.1 to 0.21.1 in SKILL.md.
- No other content or functionality changes.
v1.0.6
- Updated version in SKILL.md metadata from 0.20.0 to 0.20.1
- No usage, command, or documentation content changes detected
v1.0.5
- Version updated in metadata from 0.19.0 to 0.20.0.
- No changes to usage, flags, examples, or documentation content.
- No new functionality or options introduced.
- No breaking changes.
v1.0.4
- Updated SKILL.md metadata format and versioning.
- Removed top-level version field; version is now inside metadata.
- Minor formatting changes to improve metadata consistency.
- No functional or usage changes.
v1.0.3
- Added the --no-original-attachments flag to forward messages without including original file attachments (inline images in HTML mode are still preserved).
- Documentation expanded to clarify attachment handling, including the default inclusion of original attachments and a 25MB combined attachment size limit.
- Revised tips to note behavior differences for attachment and inline image handling between plain-text and HTML modes.
v1.0.2
- Documentation formatting updated in SKILL.md (YAML lists adjusted for consistency).
- No changes to features or functionality.
v1.0.1
- Added support for the --attach/-a flag to forward emails with attachments.
- Updated documentation for --body, --html, and attachment handling.
- Clarified usage of --html for better formatting and inline image details.
- Improved tips section to explain new features and limitations.
v1.0.0
- Initial release of gws-gmail-forward v1.0.0.
- Enables forwarding Gmail messages to new recipients via CLI.
- Supports To, CC, BCC fields, with options for plain text or HTML notes.
- Includes dry-run flag to preview requests.
- Requires configuration as described in gws-shared/SKILL.md.
Metadata
Frequently Asked Questions
What is Gws Gmail Forward?
Gmail: Forward a message to new recipients. It is an AI Agent Skill for Claude Code / OpenClaw, with 460 downloads so far.
How do I install Gws Gmail Forward?
Run "/install gws-gmail-forward" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Gmail Forward free?
Yes, Gws Gmail Forward is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Gmail Forward support?
Gws Gmail Forward is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Gmail Forward?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.14.
More Skills