skills.rest
karimStekelenburg
karimStekelenburgCOMMUNITY
Explore all skills by this author →
𝕏@ssi_karimGitHub

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
One-click install
npx skills add https://github.com/karimStekelenburg/k3m-marketplace --skill scan-inbox-karimstekelenburg
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Finance & Accounting Skills→
jieni777jieni777
1

apple-mail

Read and interact with Apple Mail accounts, mailboxes, and messages via AppleScript.

Community
Intermediate
dr-codedr-code

invoice-organizer

Extract invoice data and rename files to YYYY-MM-DD Vendor - Invoice - Description.

Community
Advanced
wyre-technologywyre-technology
39

ironscales_incidents

Manage Ironscales phishing incidents via API for triage, classification, and remediation.

Official
Advanced
ZJU-REALZJU-REAL
195

email

Manage email messages and attachments via a preconfigured himalaya CLI account.

Official
Advanced