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.

  • Go to Settings > Devices & services.

  • 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.

Email

The email address you use to sign in to Monarch Money.

Password

The password for your Monarch Money account.

Enter your MFA code

The authentication code for your Monarch Money account. This field appears after you enter your email address and password if your account requires multi-factor authentication.

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

  1. Go to Settings > Devices & services and select the integration card.
  2. 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
  3. To confirm, select Delete.
    • Home Assistant also deletes the devices and entities of the entry.
  4. If Home Assistant asks you to restart, restart Home Assistant.
  5. If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.