scan-inbox

Scans Apple Mail for invoice emails and reports new versus previously seen messages.

Updated Mar 19, 2026

Search Tags:#uv #deduplication #personal finance #invoice #bills #apple mail #email scanning

Ready to run

npx skills add https://github.com/karimStekelenburg/k3m-marketplace --skill scan-inbox-karimstekelenburg

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: scan-inbox
Source: https://github.com/karimStekelenburg/k3m-marketplace/tree/main/plugins/personal-finance/skills/scan-inbox
Command: npx skills add https://github.com/karimStekelenburg/k3m-marketplace --skill scan-inbox-karimstekelenburg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Manually hunting through Apple Mail for invoice and billing emails is tedious and error-prone, especially when tracking which messages have already been processed. This Skill automates the search and deduplicates against a local database. ## Core Features & Use Cases - Invoice Email Detection: Searches Apple Mail for invoice-related messages, bills, and payment requests within a configurable time window. - Duplicate Tracking: Compares results against a local database to distinguish new emails from previously scanned ones. - Structured Reporting: Displays new findings in a sorted table with subject, sender, date, and attachment status. - Use Case: A freelancer wants to collect all invoices received in the last 90 days for bookkeeping. Running this Skill surfaces 12 new invoice emails out of 847 scanned, ready for further processing. ## Quick Start Scan my Apple Mail inbox for invoice emails from the last 90 days and show me any new ones.

Frequently Asked Questions about scan-inbox

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

FAQPage Schema

How do I scan Apple Mail for invoice emails?▼

Run the scan-inbox Skill, which executes a Python script that searches Apple Mail for invoice-related messages. By default it looks back 90 days and reports how many emails are new versus already recorded.

How do I search emails older than 90 days in Apple Mail?▼

Pass the --days argument with a larger value, such as --days 365, to extend the search window beyond the default 90 days. This is useful when the initial scan finds no new invoice emails.

Can I store the invoice scan data in a custom directory?▼

Yes, use the --data-dir argument to specify a custom path for the scan database. If omitted, the data defaults to ~/Documents/finance-data/.

Why does the inbox scan show zero new emails?▼

Zero new emails means all matching messages were already recorded in the database from previous scans. Broaden the search window with the --days option to cover older messages not yet scanned.

What happens if the inbox scan script fails?▼

If the script exits with a non-zero code or prints an error, the Skill displays the raw error output and stops. It does not retry or attempt automatic recovery, so you must resolve the underlying issue manually.