Gws Gmail Forward
- 27.5k installs
- 30.2k repo stars
- Updated August 1, 2026
- googleworkspace/cli
gws-gmail-forward is an agent skill that Gmail: Forward a message to new recipients.
About
Gmail Forward a message to new recipients name gws-gmail-forward description Gmail Forward a message to new recipients metadata version 0 22 5 openclaw category productivity requires bins gws cliHelp gws gmail forward help gmail forward PREREQUISITE Read gws-shared SKILL md for auth global flags and security rules If missing run gws generate-skills to create it Forward a message to new recipients Usage bash gws gmail forward message-id ID to EMAILS 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
- 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.
Gws Gmail Forward by the numbers
- 27,531 all-time installs (skills.sh)
- +419 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #18 of 2,203 Security skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
gws-gmail-forward capabilities & compatibility
- Capabilities
- includes the original message with sender, date, · original attachments are included by default (ma · with html, inline images are also preserved vi · in plain text mode, inline images are not includ · use no original attachments to forward without
- Use cases
- documentation
What gws-gmail-forward says it does
If missing, run `gws generate-skills` to create it.
- 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).
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-forwardAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 27.5k |
|---|---|
| repo stars | ★ 30.2k |
| Security audit | 2 / 3 scanners passed |
| Last updated | August 1, 2026 |
| Repository | googleworkspace/cli ↗ |
What problem does gws-gmail-forward solve for developers using this skill?
Gmail: Forward a message to new recipients.
Who is it for?
Developers who need gws-gmail-forward patterns described in the cached skill documentation.
Skip if: Skip when docs are empty or the task is outside the skill's documented scope.
When should I use this skill?
Gmail: Forward a message to new recipients.
What you get
Actionable workflows and conventions from SKILL.md for gws-gmail-forward.
- Forwarded Gmail messages
- Draft forwards
- Dry-run request previews
By the numbers
- SKILL.md metadata version 0.22.5
- Documents 25MB combined attachment size limit
- Lists 7 example gws gmail +forward command patterns
Files
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 <ID> --to <EMAILS>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 dave@example.com
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body 'FYI see below'
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --cc eve@example.com
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '<p>FYI</p>' --html
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com -a notes.pdf
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --no-original-attachments
gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --draftTips
- 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 (<p>, <b>, <a>, etc.) — no <html>/<body> 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
Related skills
Entra App RegistrationCorrectly register an application in Microsoft Entra ID, configure OAuth 2.0 flows, request the right API permissions, and generate working MSAL authentication snippets484k1.3kAzure ComplianceRun automated Azure compliance scans, security posture checks, and Key Vault expiration audits before deploying.484k1.3k
Openclaw Secure Linux CloudDeploy and harden an OpenClaw agent instance on a Linux cloud server following battle-tested security defaults.270k72
Better Auth Best PracticesCorrectly configure Better Auth for secure authentication with database adapters, sessions, OAuth, email/password, and plugins in TypeScript projects.80.9k206
Firebase Security Rules AuditorAutomatically audit Firebase Firestore security rules for bypass vulnerabilities and logic gaps before deploying.80.4k397
Audit WebsiteRun comprehensive audits that surface SEO, performance, security, technical, and content issues with LLM-optimized reports and health scores.65.6k85How it compares
Use gws-gmail-forward for CLI Gmail forwards by message ID; use gws-gmail-read when extracting message bodies before deciding to forward.
FAQ
What does gws-gmail-forward do?
Gmail: Forward a message to new recipients.
When should I use gws-gmail-forward?
Gmail: Forward a message to new recipients.
Is gws-gmail-forward safe to install?
Review the Security Audits panel on this page before installing in production.