1---
2name: recipe-create-gmail-filter
3description: "Create a Gmail filter to automatically label, star, or categorize incoming messages."
4metadata:
5  version: 0.22.5
6  openclaw:
7    category: "recipe"
8    domain: "productivity"
9    requires:
10      bins:
11        - gws
12      skills:
13        - gws-gmail
14---
15 
16# Create a Gmail Filter
17 
18> **PREREQUISITE:** Load the following skills to execute this recipe: `gws-gmail`
19 
20Create a Gmail filter to automatically label, star, or categorize incoming messages.
21 
22## Steps
23 
241. List existing labels: `gws gmail users labels list --params '{"userId": "me"}' --format table`
252. Create a new label: `gws gmail users labels create --params '{"userId": "me"}' --json '{"name": "Receipts"}'`
263. Create a filter: `gws gmail users settings filters create --params '{"userId": "me"}' --json '{"criteria": {"from": "[email protected]"}, "action": {"addLabelIds": ["LABEL_ID"], "removeLabelIds": ["INBOX"]}}'`
274. Verify filter: `gws gmail users settings filters list --params '{"userId": "me"}' --format table`
28 
29