# Recipe Create Gmail Filter

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

- Skill: `vikingokft/recipe-create-gmail-filter` (Agent Skill)
- Install (CLI): `npx skillmds add vikingokft/recipe-create-gmail-filter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vikingokft/recipe-create-gmail-filter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vikingokft (https://skillmd.com/u/vikingokft)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/vikingokft/recipe-create-gmail-filter

---


# 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`