Mmcp.market

gws-gmail-forward skill

by googleworkspace·googleworkspace/cli·31k stars·Apache-2.0

Gmail: Forward a message to new recipients.

A100/100content scan

Is the gws-gmail-forward skill safe?

Clean: nothing in its files matched our rules. We read 1 file in the folder on 2026-09-28.

No findings.

Install the gws-gmail-forward skill

A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description. 

git clone --depth 1 https://github.com/googleworkspace/cli.git /tmp/cli
mkdir -p ~/.claude/skills
cp -r /tmp/cli/skills/gws-gmail-forward ~/.claude/skills/gws-gmail-forward
available in every project

In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub

The instructions your agent would load

SKILL.md as published, without the frontmatter. Read it on GitHub

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

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 (, , , etc.) — no / wrapper needed.
  • Use --draft to save the forward as a draft instead of sending it immediately.

See Also

  • gws-shared — Global flags and auth
  • gws-gmail — All send, read, and manage email commands

More skills from googleworkspace/cli

All agent skills → · MCP servers