Generated banner for Recipe Create Gmail Filter
Generated logo for Recipe Create Gmail Filter

Recipe Create Gmail Filter

Google WorkspaceOfficialPublished by Google Workspace

  • Skill
  • Workflow
  • Automation and integrations
  • Apache-2.0
  • No issues found

From the author

Create a Gmail filter to automatically label, star, or categorize incoming messages.
— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured procedure for automating email management in Gmail. It guides users through the process of identifying existing labels, creating new ones, and establishing specific filtering rules to automatically label, star, or move incoming messages out of the inbox. It relies on the gws-gmail skill to interface with the Gmail API.

What it does

  • Lists existing Gmail labels for the user account
  • Creates new custom labels for email organization
  • Defines filtering criteria based on sender or other message attributes
  • Configures automated actions such as applying labels or removing messages from the inbox
  • Verifies the successful creation of new filters

When to use it

  • When you need to organize incoming emails from specific senders automatically
  • When you want to reduce inbox clutter by moving specific messages to dedicated labels
  • When you are setting up automated workflows for email processing

Advantages

  • Reduces manual email sorting tasks
  • Ensures consistent organization of incoming communications
  • Provides a programmatic way to manage Gmail settings

Usage examples

“Create a filter for emails from [email removed] to label them as Receipts and remove them from the inbox.”
The agent will list labels, create a new 'Receipts' label if needed, and configure a Gmail filter that automatically processes incoming mail from that sender.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/googleworkspace/recipe-create-gmail-filter/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip recipe-create-gmail-filter.zip -d .agents/skills

Documentation by Google Workspace

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": "[email protected]"}, "action": {"addLabelIds": ["LABEL_ID"], "removeLabelIds": ["INBOX"]}}'

  4. Verify filter: gws gmail users settings filters list --params '{"userId": "me"}' --format table

Files

ATTRIBUTION.md

Attribution

This folder is an unmodified copy of the Agent Skill "recipe-create-gmail-filter", distributed by AutoGineer (https://autogineer.com/agent-skills).

The skill's own files are unmodified copies. AutoGineer is not affiliated with or endorsed by the author or the publisher.

Files added by AutoGineer

  • ATTRIBUTION.md: this file, written by AutoGineer

  • LICENSE: copied from LICENSE

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Google Workspace
Publisher
Google Workspace (Official)
Source
googleworkspace/cli · skills/recipe-create-gmail-filter · commit cd3697e
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google Workspace or Google Workspace.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download recipe-create-gmail-filter.zip