Firefly III

The Firefly III integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] is used as an interface to the Firefly III API. Firefly III is a free open-source personal finance manager. It contains a full transaction management system, budgets, categories and reports. You can easily import transactions via the diverse options Firefly III offers. It even contains a rule engine to automate and help organize your bookkeeping.

Prerequisites

Before you can configure Firefly III within Home Assistant, you need a few things:

  • Have Firefly III installed and a user with administrator rights
  • An access token.

Create a Firefly III Personal Access Token by following these steps:

  1. Log in to your Firefly III instance.
  2. To create an access token, follow the steps in the Firefly III documentation.
  3. Copy the generated Access Token and store it somewhere safe, you will need it in the next steps.

Configuration

To add the Firefly III integration 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 Firefly III.

  • Follow the instructions on screen to complete the setup.

Supported functionality

There is currently support for the following device types within Home Assistant:

  • Sensors - for monitoring the accounts, categories and their balances.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.

After removing the integration, consider deleting the Firefly III access token.