Skill

recipe-forward-labeled-emails

From gws

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

Install

npx claudepluginhub fakoli/fakoli-plugins --plugin gws

Tool Access

This skill uses the workspace's default tool permissions.

Preview

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

SKILL.md

Similar Skills

agent-harness-construction

Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.

everything-claude-code

157.7k

accessibility

Designs, implements, and audits WCAG 2.2 AA accessible UIs for Web (ARIA/HTML5), iOS (SwiftUI traits), and Android (Compose semantics). Audits code for compliance gaps.

everything-claude-code

157.7k

agent-eval

Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.

everything-claude-code

157.7k

Stats

Parent Repo Stars2

Parent Repo Forks0

Last CommitMar 22, 2026

Used By2 plugins

Actions

View Source View Plugin View on GitHub View README

Forward Labeled Gmail Messages

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

When to Use

Use this workflow when the user wants to forward a batch of labeled emails to someone (e.g., forwarding "needs-review" emails to a manager).

Workflow

1. Find labeled messages

gws gmail users messages list \ --params '{"userId": "me", "q": "label:LABEL_NAME"}' \ --fields "messages(id)" --format table

2. Review message contents

For each message (or a subset), get the details:

gws gmail users messages get \ --params '{"userId": "me", "id": "MSG_ID"}' \ --fields "payload.headers,snippet"

Show the user which messages will be forwarded.

3. Forward each message

For each message, use --dry-run first:

gws gmail +forward \ --message MSG_ID \ --to recipient@company.com \ --dry-run

Confirm with the user, then send.

Safety

Always preview message subjects/senders before forwarding

Use --dry-run on the first forward to confirm format

Ask the user to confirm the full batch before sending

Tips

Use Gmail's +forward helper instead of composing new emails — it preserves the thread

You can also use gws gmail +send with the original content if +forward doesn't fit the use case

Forward Labeled Gmail Messages

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

When to Use

Use this workflow when the user wants to forward a batch of labeled emails to someone (e.g., forwarding "needs-review" emails to a manager).

Workflow

1. Find labeled messages

gws gmail users messages list \
  --params '{"userId": "me", "q": "label:LABEL_NAME"}' \
  --fields "messages(id)" --format table

2. Review message contents

For each message (or a subset), get the details:

gws gmail users messages get \
  --params '{"userId": "me", "id": "MSG_ID"}' \
  --fields "payload.headers,snippet"

Show the user which messages will be forwarded.

3. Forward each message

For each message, use --dry-run first:

gws gmail +forward \
  --message MSG_ID \
  --to recipient@company.com \
  --dry-run

Confirm with the user, then send.

Safety

Always preview message subjects/senders before forwarding
Use --dry-run on the first forward to confirm format
Ask the user to confirm the full batch before sending

Tips

Use Gmail's +forward helper instead of composing new emails — it preserves the thread
You can also use gws gmail +send with the original content if +forward doesn't fit the use case