Labsco
googleworkspace logo

gws-gmail-forward

✓ Official★ 29,400

by Google · part of googleworkspace/cli

Gmail: Forward a message to new recipients.

🔥🔥✓ VerifiedFreeQuick setup
#email#documents#git#security
🧰 Not standalone. This skill ships with googleworkspace/cli and only works together with that tool — install the tool first, then add this skill.

Gmail: Forward a message to new recipients.

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by Google

Gmail: Forward a message to new recipients. npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-forward** Download ZIPGitHub29.4k

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

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

Copy & paste — that's it
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 ' FYI
' --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 ( , , , etc.) — no / wrapper needed. ** **

  • Use --draft to save the forward as a draft instead of sending it immediately. ** **

See Also

**