monarch-money

TypeScript library and CLI for Monarch Money budget management. Search transactions by date/merchant/amount, update categories, list accounts and budgets, manage authentication. Use when user asks about Monarch Money transactions, wants to categorize spending, needs to find specific transactions, or wants to automate budget tasks.

1. Przygotuj dane dostępowe: zaloguj się na https://app.monarchmoney.com, przejdź do Ustawienia > Bezpieczeństwo > Uwierzytelnianie dwuskładnikowe. Jeśli MFA jest już włączone, wyłącz je i włącz ponownie, aby uzyskać nowy klucz TOTP. Kliknij "Can't scan? View setup key" i skopiuj klucz base32 (np. JBSWY3DPEHPK3PXP). Ukończ konfigurację MFA w aplikacji Monarch Money za pomocą aplikacji autentykacyjnej.

2. Ustaw zmienne środowiskowe w swoim systemie: MONARCH_EMAIL (adres e-mail konta), MONARCH_PASSWORD (hasło) oraz MONARCH_MFA_SECRET (skopiowany klucz TOTP). Możesz to zrobić za pomocą poleceń export w terminalu lub dodać do pliku konfiguracyjnego.

3. Zainstaluj narzędzie — wymaga Node.js. Pobierz repozytorium i uruchom instalację pakietu w katalogu projektu. Po instalacji będziesz mieć dostęp do komendy monarch-money w terminalu.

4. Sprawdź konfigurację poleceniem monarch-money doctor — narzędzie zweryfikuje, czy wszystkie zmienne środowiskowe są poprawnie ustawione i połączenie z Monarch Money działa.

5. Zaloguj się poleceniem monarch-money auth login — narzędzie użyje zmiennych środowiskowych do uwierzytelnienia. Alternatywnie możesz podać dane bezpośrednio w poleceniu (flagi -e, -p, --mfa-secret).

6. Używaj głównych funkcji: monarch-money tx list --limit 10 wyświetla ostatnie transakcje, monarch-money cat list pokazuje dostępne kategorie wydatków. Możesz rozszerzyć użycie poprzez integrację z własnymi skryptami lub automatyzacją zadań budżetowych.