gws-gmail-forward
Lets your agent forward emails to new recipients. Useful for quickly sharing important information with others.
What it does
This tool resends an email you received to other people. You just need to say which email to forward and to whom.
When to use it
- ✓When you want to share an email with a colleague.
- ✓When you need to send an email to more people without copy-pasting.
- ✓When you want to save an email as a draft to send later.
Example of what to ask your AI
“Forward email with ID '123abc' to john@example.com and jane@example.com”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You provide the unique identifier of the email you want to forward and the email addresses of the new recipients. The tool handles the rest, including original attachments.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-gmail-forwardOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-gmail-forward/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
gmail +forward
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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 — Global flags and auth
- gws-gmail — All send, read, and manage email commands
FAQ
Can I add my own message along with the forwarded email?
Yes, you can add a short note or HTML text using the appropriate commands.
What if I don't want the original email's attachments?
You can use the option to exclude original attachments, but you can still add new attachments if needed.
Can I send CC or BCC recipients?
Yes, you can specify recipients for CC and BCC, in addition to the main recipients.
Details
Original description by the author
Gmail: Forward a message to new recipients.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6265
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
operator-approval-loop
Makes your agent manage message sending with human approval. It ensures important messages are reviewed before being sent.
affaan-m/ECC
discernment-nudge
Has your agent add follow-up questions after giving an important answer. It's useful for ensuring you think carefully about advice or plans before acting.
anthropics/skills
interview-me
Asks questions to understand exactly what you need. Ensures the agent grasps your real need before starting work.
addyosmani/agent-skills