Summary
The Wallet Budget & Debt Alert Notifier is an automated personal finance surveillance system designed to keep household spending and credit card liabilities strictly within defined limits.
It connects directly to the BudgetBakers Wallet MCP Server via a zero-dependency Python notifier script, runs scheduled automated evaluations three times daily through GitHub Actions, and broadcasts real-time rich alert cards with threshold warnings to dedicated Discord channels.
Homepage & Feature Highlights
- Automated Multi-Schedule Surveillance: Runs three briefings daily (Morning Briefing at 7:15 AM PHT, Evening Briefing at 5:15 PM PHT, and Nightly Check at 10:15 PM PHT).
- Budget Exhaustion Triggers: Automatically calculates monthly category spending and warns when budgets reach or exceed 80% consumption or enter deficit.
- Tiered Debt Threshold Engine: Continuously evaluates outstanding credit card balances against negative balance thresholds (from ₱20,000 up to critical ₱120,000 limit) with proactive headroom alerts.
- Rich Discord Cards: Delivers color-coded embed cards formatted with expenditure meters, remaining allowances, and
@hereemergency pings.
High-Level Architecture
