Installation

$ npx skills add streakyc/googleworkspacecli --skill gws-gmail-forward

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

License LICENSE

Default branch main

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,553 B

docs SUMMARY.md 68 B

History

Jul 15, 2026 First seen on skills.sh

Sep 9, 2026 First recorded snapshot · 1 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 above the forwarded message, used verbatim (plain text, or HTML with --html). \n is NOT a newline — use $'...' or a real line break
`--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
# Multi-line note — $'...' quoting turns \n into a real newline:
gws gmail +forward --message-id 18f1a2b3c4d --to [email protected] --body $'Dave,\n\nSee the thread below.\n\nBlake'

Tips

IMPORTANT: --body is verbatim. Writing --body "Hi,\n\nFYI" sends a literal backslash-n to the recipient; it does NOT create a line break. Use $'Hi,\n\nFYI' or "$(cat file.txt)". See gws-shared Shell 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.

gws-gmail-forward