mercury-receipt-finder

Installation
SKILL.md

Mercury Receipt Finder

Automatically find transactions that are missing receipts, then hunt for matching receipts across macOS Photos and Gmail. For each match found, confirm with the user and upload via mercury transactions attachments attach.

This skill combines local photo search (screenshots of digital receipts, photos of paper receipts) with Gmail search (order confirmations, payment receipts, invoices) to close the gap on missing documentation. Uploads are irreversible — the skill always confirms each match before attaching.

Parameters

Parameter Default Description
dateRange Last 30 days Window of transactions to scan for missing receipts.
accountFilter All accounts Restrict to specific Mercury account IDs.
cardFilter (optional) Filter transactions to a specific cardholder. Accepts a cardholder name (matched against nameOnCard from the cards API) or card last-4 digits (matched against cardLastFourDigits on transactions). Since the skill searches the current user's personal Photos and Gmail, this avoids searching for other people's receipts.
minAmount $0.00 Only look for receipts on transactions at or above this amount. Useful for focusing on material spend.
sources photos, gmail Which sources to search. Set to just photos or gmail to limit scope.
gmailQuery (auto-built) Override the Gmail search query. When set, the same query is used for all transactions — useful for searching a specific vendor across the full date range.
photosDateBuffer 5 days Days before the earliest transaction to begin the Photos search. Accounts for photos taken before the charge posts.
maxPhotoCandidates 30 Maximum images to send through vision analysis per run. If more candidates exist, the most recent are chosen.
Installs
4
GitHub Stars
4
First Seen
Jun 11, 2026