gmail-multi-inbox

Installation
SKILL.md

Gmail Multi-Inbox Setup & Maintenance

Overview

Gmail's Multiple Inboxes displays up to 5 custom sections alongside the main inbox. Each section shows emails matching a search query. This skill uses a label + filter approach: label-based sections get Gmail filters that auto-label incoming mail by sender domain. The output is always a Google Apps Script the user pastes into script.google.com.

The generated script is idempotent — safe to re-run after adding or removing senders. When senders are removed from the lists, setupAll() automatically deletes the corresponding Gmail filters.

Prerequisites

This skill requires a Gmail MCP connector (e.g. search_gmail_messages) to scan the user's inbox. Gmail does not have an official MCP server — the user must have a third-party Gmail connector configured. If no Gmail connector is available, the skill can still work in a limited way: skip the scanning steps and let the user provide sender domains manually, or import from an existing script.

Configuration

The skill stores its current configuration in assets/config.json inside this skill's directory. This file tracks:

  • The section definitions (name, query, label)
  • The sender domains assigned to each label
  • Timestamp of last scan
Related skills
Installs
24
Repository
apocohq/skills
GitHub Stars
4
First Seen
Feb 18, 2026