It’s a free Python script that scrapes energy consumption data from the Veolia IDF and/or GRDF websites using your login credentials and uploads it to Home Assistant or Domoticz for energy tracking and automation.

It supports Home Assistant and Domoticz, allowing users to monitor their gas and water consumption directly within their smart home dashboards.

The script works with Veolia (water) and GRDF (gas) meter data via their respective customer portals.

Basic experience with Python and running command-line tools is recommended. Users should be comfortable installing dependencies and editing configuration files.

Data can typically be fetched once daily due to the limitations of the provider websites and to avoid account lockouts.

No. It’s an open-source, community-driven tool and not officially supported by Veolia or GRDF.
 

The biggest limitation is CAPTCHA protection on the provider websites (especially Veolia), which can block automated login attempts.

Yes, you can use tools like cron (Linux) or Task Scheduler (Windows) to automate the script execution.
 

Veolia's login system often uses CAPTCHA challenges that block automated logins. Meters To HA cannot bypass this alone, which makes CaptchaAI essential for continuous, unattended data scraping.

Most CAPTCHA providers struggle with image-based login pages like Veolia’s. CaptchaAI supports image CAPTCHA solving through direct Base64 uploads and offers reliable results, solving the key bottleneck that breaks automation.