# Recipe Forward Labeled Emails

Find Gmail messages with a specific label and forward them to another address.

- Repository: https://github.com/googleworkspace/cli (32044 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add googleworkspace/cli --skill recipe-forward-labeled-emails -g -a claude-code -y`
Codex: `npx skills add googleworkspace/cli --skill recipe-forward-labeled-emails -g -a codex -y`
Cursor: `npx skills add googleworkspace/cli --skill recipe-forward-labeled-emails -g -a cursor -y`
Gemini CLI: `npx skills add googleworkspace/cli --skill recipe-forward-labeled-emails -g -a gemini-cli -y`

## Description

Find Gmail messages with a specific label and forward them to another address.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

1. Find labeled messages: `gws gmail users messages list --params '{"userId": "me", "q": "label:needs-review"}' --format table`
2. Get message content: `gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID"}'`
3. Forward via new email: `gws gmail +send --to manager@company.com --subject 'FW: [Original Subject]' --body 'Forwarding for your review:

[Original Message Body]'`