Recipe Forward Labeled Emails

This recipe automates the tedious process of finding Gmail messages with specific labels and forwarding them to another email address. You'd use this when you need to regularly send labeled emails to managers, team members, or external stakeholders for review or action. It runs three specific commands: searches for messages by label using Gmail's query syntax, retrieves the full message content including subject and body, then sends a new forwarded email with proper formatting. The workflow is straightforward but saves significant manual clicking when you're processing batches of labeled messages that need to be routed elsewhere.

skills.sh installs: 30.7K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill recipe-forward-labeled-emails --agent claude-code

Installs into .claude/skills of the current project.

Files

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]'`

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly