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:
- Log in to your Firefly III instance.
- To create an access token, follow the steps in the Firefly III documentation.
- Copy the generated Access Token and store it somewhere safe, you will need it in the next steps.
Configuration
To add the Firefly III 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 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
- 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.
After removing the integration, consider deleting the Firefly III access token.