Monarch Money
Monarch Money is a personal finance aggregation and budgeting service that integrates with Plaid, MX, and FinCity, the three major financial backends.
Prerequisites
- You need a Monarch Money account to use this integration.
- You need the email address and password for your Monarch Money account. If you use multi-factor authentication (MFA), you also need your authentication code during setup.
Configuration
To add the Monarch Money service to your Home Assistant instance, use this My button:
Manual configuration steps
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Monarch Money.
-
Follow the instructions on screen to complete the setup.
Accounts & devices
Each account is set up as a device in Home Assistant and contains the following sensors:
- Balance: The account balance.
- Age: When Monarch Money last retrieved the data.
- Owner: The institution owner in Monarch Money.
Budgets
Each budget category is set up as a service device in Home Assistant and contains the following sensors for the current month:
- Budget actual: The actual amount recorded for the category.
- Budget planned: The amount budgeted for the category.
- Budget remaining: The remaining amount reported by Monarch Money, including rollover from previous months.
Budget data updates every four hours. New categories appear after the next update.
If Monarch Money returns a category without current-month data, its device and sensors still appear, but the sensors are Unavailable until data is available. If current-month data is available but an individual amount is missing, that sensor shows as Unknown.
Removing the integration
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- Next to the entry you want to remove, select the three dots
menu. Then, select Delete. - Depending on the integration, the entries are listed under one of the following headings:
- Devices
- Hubs
- Services
- Integration entries
- Depending on the integration, the entries are listed under one of the following headings:
- To confirm, select Delete.
- Home Assistant also deletes the devices and entities of the entry.
- If Home Assistant asks you to restart, restart Home Assistant.
- If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
- If you keep them, Home Assistant uses them automatically when you add the integration again.
- To delete them later, refer to Deleting application credentials.