This is a custom Home Assistant integration that connects to the FatSecret API to fetch your nutrition data for today (calories, macros, etc.) and expose them as sensors.
- Requires a FatSecret API account to obtain the
Consumer Keyand theConsumer Secretwhen installing the integration. - Data is fetched for the current day.
- Sensors update every 15 minutes.
- Go to the HACS Integration Tab
- Search the
FatSecretcomponent and click on it. - Click Download button at the bottom of the page. A pop up will be shown informing you that the component will be installed in the folder
/config/custom_components/fatsecret. Click Download.
- Clone or download the GitHub repository: ha-fatsecret
- Copy the
custom_components/fatsecretfolder to your Home Assistantconfig/custom_components/directory: config/custom_components/fatsecret - Restart Home Assistant.
- Go to Settings > Devices & Services > Devices > Add Device.
- Search for
FatSecretand add it. - Enter your credentials (
Consumer Keyand theConsumer Secret) from the FatSecret Platform API - A new popup window wil show you a FatSecret URL and a
verifierfield. Click on the URL - A FatSecret page will ask you to sign in to your FatSecret account to obtain the verifier code. Use your FatSecret username and password. Do not use the FatSecret Platform API credentials. Once signed in, copy the code and put this code in the verifier field of the FatSecret popup window.
The integration provides a service to manually refresh data: update_fatsecret
If you encounter any issues or would like to suggest improvements:
- Open an issue on GitHub: https://github.com/xplanes/ha-fatsecret/issues
- Pull requests are welcome!
Please include logs or reproduction steps when reporting bugs.
This project is licensed under the MIT License. See the LICENSE file for full license text.
© 2025 @xplanes