scan-inbox

The scan-inbox skill provides an automated, privacy-focused solution for triaging your Apple Mail inbox on macOS. Designed for professionals overwhelmed by high email volumes, this agent acts as a virtual assistant to distill chaotic inboxes into actionable intelligence. By leveraging AppleScript automation via the Bash toolchain, the agent scans your mail accounts locally to identify critical communications without ever exposing your private email body content to external servers. It effectively filters messages based on temporal range and keyword heuristics, helping users maintain focus on urgent items and deadlines.

• Automatically scans all inbox accounts in Apple Mail with customizable look-back windows (default 24 hours).

• Employs pattern matching to detect actionable keywords such as urgent, deadline, action required, request, or meeting.

• Categorizes mail into unread, actionable, and priority-flagged buckets to improve triage efficiency.

• Delivers structured output summaries including counts and specific metadata (sender, subject, date, and flags).

• Facilitates proactive workflow management by identifying top tasks directly from email subjects.

• Supports follow-up orchestration, including flagging messages or initiating deep-dive extractions from specific threads.

• Always verify macOS Automation permissions in System Settings (Privacy & Security) for the host terminal or Claude client to ensure smooth script execution.

• Default behavior scans the last 24 hours; users can specify custom hour ranges for broader searches like 48 or 72 hours.

• The tool is strictly metadata-focused, prioritizing user privacy by excluding email body parsing from its default operation.

• In the event of execution timeouts, try reducing the time range or ensuring Apple Mail is fully synchronized before triggering the scan.

• This agent is ideal for daily briefing routines, email triage, and ensuring no time-sensitive requests are missed during busy periods.