Hydro-Québec for Home Assistant (Marketplace integration)

Installs: 558 sharing analytics
GitHub stars: 92
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v0.7.0, October 24, 2026
Category: Energy, Meters and monitoring
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: hydroqc
Source: github.com/hydroqc/hydroqc-ha
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Hydro-Québec is an integration that tracks electricity use, billing and peak periods for a Hydro-Québec account. It connects through the vendor's cloud, either by signing in with an account or in a public data mode that needs no login and covers peak alerts only. With an account, it adds sensors for balance, billing period, projected bill, consumption averages and current rate, plus binary sensors for critical peak periods, pre-heating and portal status. Hourly consumption history can be imported for the Energy dashboard, with a choice of how many days to bring in. For the peak-based rates, a dedicated calendar stores peak events, and a service can create a critical peak event by hand. A pre-heat duration and the data update interval can be adjusted, and several contracts can be managed, such as a home and a cottage. It is set up in the UI and is developed independently of Hydro-Québec.

Automatic summary of the README and code of hydroqc/hydroqc-ha. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Choose Connection Mode

Connection ModePortal Mode: Sign in for full account access. OpenData Mode: Use public data only (no login required)

Portal Mode - Account Login

Username (Email)Your Hydro-Québec account email address
PasswordYour Hydro-Québec account password
Contract NameA friendly name for this contract (e.g., 'Home', 'Cottage')

Select Contract

ContractSelect the contract you want to add to Home Assistant

Configure Pre-heat Duration

Pre-heat Duration (minutes)Duration before critical peak events to trigger pre-heating (0-240 minutes, default: 120)

Calendar Configuration (Required)

Calendar EntitySelect a dedicated calendar entity for peak events. This calendar will store all peak periods.

Also asked when at the calendar configuration (required) step.

Import Consumption History

Days of History to ImportNumber of days to import (0-800). Set to 0 to sync only the last 30 days, or enter a value for older history.

OpenData Mode - Select Sector

Customer SectorSelect whether you are a residential or commercial customer

After setup

Update Interval (seconds)How often to fetch data from Hydro-Québec (30-600 seconds)
Pre-heat Duration (minutes)Duration before critical peak events to trigger pre-heating (0-240 minutes)
Enable consumption synchronizationEnable to sync hourly consumption data for the energy dashboard. Requires integration reload to take effect.
Calendar EntityCalendar entity for peak events (DPC/DCPC rates only). Required for peak sensors to work.

Texts from the code of hydroqc/hydroqc-ha.

Entities

Binary sensorsEPP Active, Critical Period, Critical Peak Active, Preheat Active, Next Anchor Critical, Next Peak Critical, Upcoming Critical Peak, Morning Peak Today, Evening Peak Today, Morning Peak Tomorrow, Evening Peak Tomorrow, Portal Status
SensorsBalance, Billing Period Day, Billing Period Duration, Bill Total to Date, Projected Bill, Daily Bill Average, Daily Consumption Average, Total Consumption, Projected Total Consumption, Average Temperature, Average kWh Cost, Current Rate, and 26 more

From the README

Surveillez et automatisez votre consommation électrique directement dans Home Assistant.
Navigation rapide: Installation • Configuration • Blueprints • Capteurs • FAQ

From the README of hydroqc/hydroqc-ha, GNU AGPL v3.0. Shortened.