skilld
All skills
googleworkspace avatar

/gws-gmail-forward

@705fb0e
by Google Workspacegoogleworkspace/cli31k stars
1,856

Gmail: Forward a message to new recipients.

Ask your Agent

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-gmail-forward

This session only. Nothing lands on disk.

SKILL.md

≈16 tokens always: the name and description. ≈715 when used: this file.

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

Source: SKILL.md on GitHub

Third-party checks

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill enables an AI agent to forward Gmail messages using the gws command-line tool. It adheres to standard vendor patterns for Google Workspace functionality and does not contain malicious patterns or obfuscation.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: MEDIUM · 1 issue

  • Runlayer6mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 705fb0e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 6 months ago

Capability

Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws gmail +forward --help"
  }
}

Topics

  • CLI
  • gmail
  • google-workspace
  • email
  • forwarding
  • gws

README badge

README badge for googleworkspace/cli/gws-gmail-forward

What it does

Forwards a Gmail message to new recipients with optional notes, attachments, and draft mode via the gws CLI. Supports plain text or HTML bodies, CC/BCC, file attachments up to 25MB total, and preserves original message headers and attachments by default.

Generated from the current SKILL.md.

Frequently asked

Does this skill require authentication?
Yes. You must configure Google Workspace auth as described in the gws-shared skill, which handles credential setup and security rules.
Can I forward a message without including the original attachments?
Yes. Use the --no-original-attachments flag to exclude files from the original message (inline images in HTML mode are still preserved).
What's the attachment size limit?
The combined size of original and user-added attachments is limited to 25MB.
Can I save a forward as a draft instead of sending it immediately?
Yes. Use the --draft flag to save the forward as a draft instead of sending.

Generated from the current SKILL.md. These answers refresh after source changes.