mcpbeat

Gws Gmail Forward

googleworkspace/gws-gmail-forward

Gmail: Forward a message to new recipients.

775 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
30175
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-forward

The instruction itself

6 sections, as written by the author

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 — Global flags and auth
  • gws-gmail — All send, read, and manage email commands

How to use it

Copy the folder

Take googleworkspace/gws-gmail-forward from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.