Agent Plugins Marketplace
← All plugins

gmail-workflows

v0.1.0

Gmail workflow skills for labels, filters, inbox audits, rule audits, and label colours.

CodexClaude Code6 Skills

By Matcluck2 GitHub starsUpdated last month

Directory evidence

Runtimes
Codex and Claude Code
Parsed components
6 skill or MCP entries
Source updated
Sep 18, 2026
Manifest status
Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install gmail-workflows for Codex and Claude Code

Installs for the current user
codex plugin marketplace add matcluck/gmail-organiser
codex plugin marketplace upgrade gmail-workflows-marketplace
codex plugin add gmail-workflows@gmail-workflows-marketplace

Paste and run these commands in a terminal with Codex. They add and refresh the gmail-workflows-marketplace catalog, then install this plugin.

Compatibility: the page URL and API slug “gmail-workflows” remain stable.

  • Codex: gmail-workflows@agent-plugin-marketplace → gmail-workflows@gmail-workflows-marketplace

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually
git clone https://github.com/matcluck/gmail-organiser

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

gmail-workflows/
├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/gmail/SKILL.md
├── skills/gmail-add-label/SKILL.md
├── skills/gmail-add-rules/SKILL.md
├── skills/gmail-audit-inbox/SKILL.md
├── skills/gmail-audit-rules/SKILL.md
└── skills/gmail-colour-labels/SKILL.md

Included Skills6

gmailskills/gmail/SKILL.md

Shared Gmail automation skill for labels, persistent filters, browser-driven Gmail settings, Gmail connector cleanup, filter criteria safety, and the inbox-first two-rule filter strategy. Use whenever Codex needs to interact with Gmail, create or edit Gmail labels/filters, archive/delete/search mail, audit Gmail state, or support companion skills gmail-add-rules, gmail-add-label, gmail-audit-rules, and gmail-audit-inbox.

gmail-add-labelskills/gmail-add-label/SKILL.md

Create, verify, and optionally apply Gmail labels. Use when Codex is asked to add a Gmail label, create a nested label path, ensure a label exists before creating filters, label current messages from a search, or implement explicit requests like "gmail-add-label", "Gmail Add Label", "make a Gmail label", or "label these emails".

gmail-add-rulesskills/gmail-add-rules/SKILL.md

Add Gmail persistent filters using the inbox-first two-rule pattern. Use when Codex is asked to create Gmail rules, add filters for a sender or mailing list, label all mail from a sender, create skip-inbox keyword rules, or implement "base/tag plus skip" Gmail automation. Also use for explicit requests like "gmail-add-rules", "Gmail Add Rules", "add a Gmail rule", "add a skip rule", or "make future emails from this sender skip inbox".

gmail-audit-inboxskills/gmail-audit-inbox/SKILL.md

Audit Gmail inbox messages for recurring senders that need base/tag filters or conservative skip-inbox keyword filters, then interview the user in batches of up to 8 proposed rule changes. Use for gmail:audit-inbox, /gmail:audit-inbox, "audit my inbox", "filter out inbox noise", "look at my inbox and interview me", or requests to find Gmail messages that should automatically skip inbox.

gmail-audit-rulesskills/gmail-audit-rules/SKILL.md

Audit existing Gmail filters against the inbox-first two-rule contract, identify missing base filters, unsafe skip filters, mark-as-read violations, missing Never Spam, duplicate/ambiguous filters, and documented override exceptions. Use for gmail:audit-rules, /gmail:audit-rules, "audit Gmail rules", "check my Gmail filters", or any request to review existing Gmail filter configuration.

gmail-colour-labelsskills/gmail-colour-labels/SKILL.md

Apply, standardize, audit, or bulk update Gmail label colours using the existing Gmail browser automation helpers. Use when Codex is asked to colour/color Gmail labels, auto-colour labels, standardize a Gmail label palette, set label colours from a mapping, or review Gmail label colour consistency.

Plugin manifests2

.codex-plugin/plugin.json
{
  "name": "gmail-workflows",
  "version": "0.1.0",
  "description": "Gmail workflow skills for labels, filters, inbox audits, rule audits, and label colours.",
  "author": {
    "name": "Matcluck"
  },
  "keywords": [
    "gmail",
    "email",
    "filters",
    "labels",
    "inbox"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Gmail Workflows",
    "shortDescription": "Gmail labels, filters, audits, and cleanup",
    "longDescription": "Reusable Gmail workflow skills for creating labels, adding inbox-first filter rules, auditing inbox messages, auditing persistent rules, and managing label colours.",
    "developerName": "Matcluck",
    "category": "Productivity",
    "capabilities": [
      "Interactive",
      "Write"
    ],
    "defaultPrompt": [
      "Audit my Gmail inbox for new filter candidates.",
      "Add Gmail rules for this sender.",
      "Create a nested Gmail label."
    ],
    "brandColor": "#1A73E8"
  }
}
.claude-plugin/plugin.json
{
  "name": "gmail-workflows",
  "description": "Gmail workflow skills for labels, filters, inbox audits, rule audits, and label colours.",
  "version": "0.1.0",
  "author": {
    "name": "Matcluck"
  },
  "keywords": [
    "gmail",
    "email",
    "filters",
    "labels",
    "inbox"
  ],
  "skills": "./skills/",
  "category": "Productivity"
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[gmail-workflows on Agent Plugins Marketplace](https://pluginsmp.com/plugins/gmail-workflows)