skills.rest
n0rvyn
n0rvynCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

mail

Manage macOS Mail messages and mailboxes via scripted AppleScript actions.

1|Updated Feb 15, 2026
Search Tags:#automation#email#macos#applescript#mail#inbox-cleanup#applemail
One-click install
npx skills add https://github.com/n0rvyn/indie-toolkit --skill mail-n0rvyn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mail
Source: https://github.com/n0rvyn/indie-toolkit/tree/main/mactools/skills/mail
Command: npx skills add https://github.com/n0rvyn/indie-toolkit --skill mail-n0rvyn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Many users struggle to quickly find, read, and triage messages across local macOS Mail accounts and mailboxes; this Skill provides deterministic tools to search, read, flag, move, and batch-clean messages so inboxes can be organized efficiently without manual, repetitive UI work.

Core Features & Use Cases

  • List mail accounts and mailboxes to understand mailbox structure and unread counts.
  • Inspect inboxes and unread messages across accounts with indexed results for precise actions.
  • Read full message content including headers, mark messages read, toggle flags, move messages between mailboxes, and move messages to Trash (recoverable).
  • Perform keyword searches across subjects, senders, and body content and act on matched messages.
  • Batch-trash message ranges with index-order deletion to avoid index shifting during bulk cleanup.
  • Use Case: Run an unread sweep for an iCloud inbox, read candidate messages, extract actionable TODOs, and batch-move low-value messages to Trash.

Quick Start

Show unread messages in my iCloud inbox, read the top three, and propose which ones to archive or trash.

Frequently Asked Questions about mail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate macOS Mail inbox cleanup without manual dragging?▼

Automated inbox cleanup is achieved through scripted AppleScript actions that search, flag, and batch-trash messages. This handles message triage and organization without repetitive manual UI interactions.

Can I batch move multiple unread messages to Trash in Apple Mail?▼

Batch moving unread messages to Trash in Apple Mail is supported using index-order deletion. This prevents index shifting during bulk cleanup, ensuring accurate message removal across selected mailboxes.

Do I need specific permissions to run AppleScript automation for Mail.app?▼

Running AppleScript automation for Mail.app requires macOS automation permissions and the Mail application to be actively running. These permissions allow the bundled shell scripts to execute deterministic mailbox operations.

How does searching messages by sender and subject work in local macOS Mail?▼

Searching messages by sender and subject in local macOS Mail works by applying keyword searches across message headers and body content. Matched messages are indexed precisely so you can act on them directly.

What is the best way to list all mail accounts and unread counts on macOS?▼

Listing all mail accounts and unread counts on macOS is handled by querying the local Mail.app structure. This provides a clear view of your mailbox organization and unread messages across all configured accounts.

Related Skills

Explore More Content & Communication Skills→
Yaron9Yaron9
18

macos-mail-calendar

Read Mail metadata and query Calendar events via AppleScript on macOS.

Community
Advanced
christophevgchristophevg

pa-email

Process unread emails into TODOs, replies, and archived messages via MCP tools.

Community
Intermediate
PaneriVatsalPaneriVatsal

personal-assistant

Manage personal tasks, schedules, preferences, and conversational context with JSON-backed storage.

Community
Advanced
wangqianCAIwangqianCAI

himalaya

Manage IMAP and SMTP email accounts from the terminal.

Community
Intermediate