gws-gmail-forward

Forward Gmail messages to new recipients with optional notes and attachments. Requires a Gmail message ID and one or more recipient addresses; supports CC, BCC, and sender aliases Allows optional plain-text or HTML message bodies to precede the forwarded content, plus multiple file attachments Preserves original message metadata (sender, date, subject, recipients) in the forwarded block using Gmail's standard quote formatting Includes dry-run mode to preview the request before sending

INSTALLATION
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-forward
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

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

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 --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

  • gws-gmail — All send, read, and manage email commands
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card