gws-gmail-forward
Gmail: Forward a message to new recipients.
By googleworkspace · 30,771 installs
npx skills add googleworkspace/cli --skill gws-gmail-forward
Source repository · Upstream listing
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
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
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 (<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](../gws shared/SKILL.md) — Global flags and auth
[gws gmail](../gws gmail/SKILL.md) — All send, read, and manage email commands