Agent skill · writing content · googleworkspace
gws-gmail-forward
Gmail: Forward a message to new recipients.
Why this skill is useful
Adds specific command usage for forwarding Gmail messages that the AI wouldn't reliably generate on its own.
What it needs
Requires gws installed locally. About 2k tokens when loaded. Last updated 2026-08-01. 30,245 stars on the source repository.
What this skill does
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 gmailquote 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
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills googleworkspace/gws-gmail-forward