recipe-forward-labeled-emails
Lets your agent find and forward emails with a specific label. It sends these emails to another address.
What it does
This tool finds and forwards emails from your Gmail that have a specific label to another email address. It's like organizing your inbox and automatically sending copies of important emails.
When to use it
- ✓When you want to send all emails with the 'urgent' label to your boss.
- ✓To forward customer emails with the 'support' label to the service team.
- ✓When you want to save copies of emails with the 'invoices' label to another account.
Example of what to ask your AI
“Forward all emails with the 'review' label to my manager.”
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
The tool first searches your Gmail for emails with the label you specify. Then, it takes the content of those emails and sends them as a new email to the address you choose.
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 recipe-forward-labeled-emailsOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/recipe-forward-labeled-emails/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
Forward Labeled Gmail Messages
PREREQUISITE: Load the following skills to execute this recipe:
gws-gmail
Find Gmail messages with a specific label and forward them to another address.
Steps
- Find labeled messages:
gws gmail users messages list --params '{"userId": "me", "q": "label:needs-review"}' --format table - Get message content:
gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID"}' - Forward via new email: `gws gmail +send --to manager@company.com --subject 'FW: [Original Subject]' --body 'Forwarding for your review:
[Original Message Body]'`
FAQ
Do I need to install anything else?
Yes, you need to have the 'gws-gmail' skill loaded for this one to work.
Can I choose where the emails are forwarded?
Yes, you provide the destination email address when using the tool.
Can I choose which label to use?
Yes, you specify the label the tool should look for in your Gmail.
Details
Original description by the author
Find Gmail messages with a specific label and forward them to another address.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6326
- 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
benchmark
Helps your agent measure code speed and performance. It's useful for ensuring things are fast and finding slowness issues.
affaan-m/ECC
content-hash-cache-pattern
Lets your agent use content hashes to cache file processing results. This avoids repeated processing and auto-invalidates the cache when content changes. Useful for speeding up slow tasks.
affaan-m/ECC
parallel-execution-optimizer
Makes your agent speed up complex tasks by breaking them into smaller parts and running them in parallel. It ensures everything is verified at the end.
affaan-m/ECC