/recipe-create-gmail-filter

allowed-tools: Bash, Read, Write, Edit
argument-hint: [task-parameters]
description: Create a Gmail filter to automatically label, star, or categorize incoming messages.

Create Gmail Filter

Execute Google Workspace workflow: $ARGUMENTS

Create a Gmail Filter

> **PREREQUISITE:** Load the following skills to execute this recipe: `gws-gmail`

Create a Gmail filter to automatically label, star, or categorize incoming messages.

Steps

1. List existing labels: `gws gmail users labels list --params '{"userId": "me"}' --format table` 2. Create a new label: `gws gmail users labels create --params '{"userId": "me"}' --json '{"name": "Receipts"}'` 3. Create a filter: `gws gmail users settings filters create --params '{"userId": "me"}' --json '{"criteria": {"from": "receipts@example.com"}, "action": {"addLabelIds": ["LABEL_ID"], "removeLabelIds": ["INBOX"]}}'` 4. Verify filter: `gws gmail users settings filters list --params '{"userId": "me"}' --format table`

Task

Execute this workflow with the following parameters: $ARGUMENTS

1. **Prerequisites Check**

• Verify `gws` CLI is installed: `gws --version`
• Confirm authentication: `gws auth status`
• Load required GWS skills (check PREREQUISITE section above)

2. **Parameter Preparation**

• Parse task parameters from $ARGUMENTS
• Validate required inputs
• Prepare JSON payloads and flags

3. **Execute Workflow Steps**

• Follow the steps outlined above
• Replace placeholder IDs with actual values
• Handle errors and retries
• Log progress and results

4. **Verify Results**

• Confirm each step completed successfully
• Verify changes in Google Workspace
• Report final status and any issues

Tips

• Use `--dry-run` flag when available to preview changes
• Always inspect API schemas before calling: `gws schema <service>.<resource>.<method>`
• Check command help for all flags: `gws <service> <resource> <method> --help`

---

**License**: Apache License 2.0 **Source**: [Google Workspace CLI](https://github.com/googleworkspace/cli) **Original Skill**: `recipe-create-gmail-filter`