SkillsAdd

googleworkspace/cli · Official

gws-gmail-forward

Gmail: Forward a message to new recipients.

All-time #863 Trending #1891 First seen Mar 9, 2026
8-week activity · all time api

Installation

$ npx skills add googleworkspace/cli --skill gws-gmail-forward
View on skills.sh ↗ GitHub repository ↗
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

Summary

  • 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

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

roll-forward Similar name
anthropics/financial-services

Build a roll-forward schedule for a balance-sheet account — beginning balance plus activity les…

1.1K installs
forward-risk Similar name
joellewis/finance_skills

Estimate potential future losses using VaR, Expected Shortfall, Monte Carlo simulation, and str…

540 installs

Security audits

Partner security reviews for this skill.

agent-trust-hub Reviewed

Analyzed Sep 15, 2026

snyk Reviewed

Analyzed Sep 15, 2026

socket Score 0.9000 · 0 alerts

Analyzed Sep 15, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli
gws-gmail 239 gws-gmail-send 182 gws-drive 224 gws-shared 222 gws-calendar 210 gws-sheets 217 gws-docs 224 gws-sheets-read 193 gws-docs-write 198 gws-calendar-agenda 186

Browse all from googleworkspace/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 30.8K
License LICENSE
Default branch main
Open issues 129
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws gmail +forward --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,102 B
  • docs SUMMARY.md 68 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 30,439 installs

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 [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 '<p>FYI</p>' --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 (<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