subscriptions_detect
Scans transaction history for recurring monthly charges, saves them as tracked bills, and flags unsupported cadences or subscriptions needing review.
Instructions
Detect recurring charges from history and save them as tracked bills.
Scans the archive for merchants with repeated, same-amount, monthly-spaced
debits and writes each as a recurring bill in the budget config (creating
the config if absent), so your subscriptions become a saved list rather than
something re-inferred on every audit. Idempotent: a merchant already tracked
is skipped. Dates are YYYY-MM-DD; end defaults to today and start to
a year back. day_tolerance (default 7) is the day-of-month drift allowed
when deciding whether a charge is already covered by an existing bill.
Weekly/yearly merchants are reported under unsupported_cadence (only
monthly bills are tracked). Monthly merchants that could not be auto-tracked
— text too generic/variable to pin, or a recurring charge at a different
price from an already-tracked subscription — are reported under
needs_review (each with a reason) rather than written.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| start | No | ||
| day_tolerance | No | ||
| min_occurrences | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||