SkillsAdd

googleworkspace/cli · Official

gws-gmail-forward

Gmail: Forward a message to new recipients.

All-time #745 Trending #1482 Hot #699 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 ↗

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

Stronger alternatives

Audit results are mixed — compare nearby options before installing.

gws-gmail Same source · more installs
googleworkspace/cli

Gmail: Send, read, and manage email.

74.7K installs
gws-gmail-send Same source · more installs
googleworkspace/cli

Gmail: Send an email.

69.5K installs
gws-drive Same source · more installs
googleworkspace/cli

Google Drive: Manage files, folders, and shared drives.

68K installs
gws-shared Same source · more installs
googleworkspace/cli

gws CLI: Shared patterns for authentication, global flags, and output formatting.

59.4K installs

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 SAFE

Analyzed Mar 31, 2026

This skill allows an AI agent to forward Gmail messages using the Google Workspace CLI. It is functional and uses vendor-provided tools, but it carries a low-risk surface for indirect prompt injection because it processes untrusted email content without explicit boundary markers.

snyk LOW

Analyzed Mar 31, 2026

No issues detected.

socket Score 0.9000 · 1 alerts

Analyzed Mar 31, 2026

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

1 alert

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli
gws-gmail 74.7K gws-gmail-send 69.5K gws-drive 68K gws-shared 59.4K gws-calendar 55.1K gws-sheets 52.5K gws-docs 52K gws-sheets-read 45.1K gws-docs-write 44.6K gws-calendar-agenda 44.2K

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