Skill
gws-admin-reports
Google Workspace Admin SDK: Audit logs and usage reports.
@googleworkspaceView SkillDevelopment
Skill
/gws-gmail-forward
Gmail: Forward a message to new recipients.
Install
$ npx -y skills add googleworkspace/cli --skill gws-gmail-forward --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/gws-gmail-forward
Context preview
The summary Claude sees to decide when to auto-load this skill.
Gmail: Forward a message to new recipients.
SKILL.md
gws-gmail-forward.SKILL.mdname: gws-gmail-forward
description: "Gmail: Forward a message to new recipients."
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws gmail +forward --help"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 (<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
Read more
name: gws-gmail-forward
description: "Gmail: Forward a message to new recipients."
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws gmail +forward --help"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 (<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
Ships withgoogleworkspace-cli
Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.
Get the whole plugin
Stats
31,012
Stars
1,833
Forks
Active
Maintenance
Rust
Language
Apache-2.0
License
1d ago
Last commit
6mo ago
Created
Repo: googleworkspace/cli
Other skills on googleworkspace-cli.
@googleworkspaceView SkillSkill
gws-calendar-agenda
Google Calendar: Show upcoming events across all calendars.
@googleworkspaceView SkillSkill
Skill
Skill
Skill