--- title: "HA & FoxESSCloud integration" description: "HA & FoxESSCloud integration is a Marketplace integration for Home Assistant. It has 1.5k installs sharing analytics, needs the vendor's cloud and was last updated October 26, 2026." canonical: "https://vulpo.app/integrations/marketplace/macxq-foxess-ha" url: "https://vulpo.app/integrations/marketplace/macxq-foxess-ha.md" last-updated: "2026-10-26" version: "1.4" --- # HA & FoxESSCloud integration > HA & FoxESSCloud integration is a Marketplace integration for Home Assistant. It has 1.5k installs sharing analytics, needs the vendor's cloud and was last updated October 26, 2026. HA & FoxESSCloud integration monitors a FoxESS photovoltaic installation from Home Assistant through sensors. It connects with a FoxESS Cloud API key and then lets the user pick an inverter, with each inverter added as its own entry. Options cover extended PV string reading for Fox R series inverters or any inverter with more than six strings, a FoxESS EVO series mode, and a time zone adjustment for inverter timestamps. A reduced API calls mode polls less often to stay within the FoxESS daily call quota, which matters for multi-inverter setups. A daily energy sanity check threshold ignores readings above a set value, so corrupted spikes do not reach the Energy Dashboard statistics. Older YAML configurations are imported automatically into a UI entry with entity IDs and history kept. Automatic summary of the README and code of macxq/foxess-ha. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=macxq&repository=foxess-ha&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=macxq&repository=foxess-ha&category=integration) ## 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. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### FoxESS Cloud - **API Key** Also asked when signing in again. ### Select Device - **Device** - **Name** - **Extended PV strings (PV7–18)**: Enable for Fox R series inverters or any inverter with more than 6 PV strings. Reads voltage, current, and power for PV strings 7–18. - **Reduced API calls mode (Eco mode)**: Polls telemetry every 10 minutes instead of 5 minutes to stay well below the FoxESS 1,440 daily API quota. ### After setup - **Assigned Inverter**: The serial number of this inverter. - **API Key** - **Daily energy sanity check threshold (kWh)**: Maximum expected daily energy generation in kWh. Readings above this threshold are ignored to protect Energy Dashboard statistics from corrupted spikes (default: 100 kWh). - **Reduced API calls mode (Eco mode)**: Halves API polling frequency (10-minute intervals) to prevent exceeding the FoxESS 1,440 daily call quota, especially useful for multi-inverter setups or accounts linked to VPP providers. - **Extended PV strings (PV7–18)**: Enable for Fox R series or inverters with more than 6 PV strings. - **FoxESS EVO series mode**: Enable if using a FoxESS EVO inverter where device details are incomplete. - **Cross Time Zone adjustment**: Enable if inverter timestamps use a different time zone than Home Assistant. - **Restrict API variables**: Enable if Fox Cloud returns errors for large variable lists. Texts from the code of [macxq/foxess-ha](https://github.com/macxq/foxess-ha). ## At a glance - Kind: Marketplace integration - Category: [Energy](https://vulpo.app/integrations/category/energy.md), Solar and batteries - Brand: [FoxESS](https://vulpo.app/integrations/foxess.md) - Number: 1.5k installs sharing analytics; 219 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v0.58, last updated October 26, 2026 - Domain: `foxess` - Source: - Issues: In Vulpo: Chart card, Apple Watch ## Other ways in for FoxESS | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [FoxESS - Modbus](https://vulpo.app/integrations/marketplace/nathanmarlor-foxess-modbus.md) | Marketplace integration | 1.3k installs sharing analytics | Works locally | Updated in the last 6 months | | [FoxESSCloud API](https://vulpo.app/integrations/marketplace/softxperience-home-assistant-foxess-api.md) | Marketplace integration | 292 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [FoxESS Control](https://vulpo.app/integrations/marketplace/nicois-foxess-control.md) | Marketplace integration | 121 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [FoxESS OpenAPI](https://github.com/fruffin/home-assistant-foxess-openapi) | Marketplace integration | 46 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [FoxESS T Series](https://github.com/LucasTor/FoxESS-T-series) | Marketplace integration | 10 installs sharing analytics | Works locally | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-26. Source: https://vulpo.app/integrations/marketplace/macxq-foxess-ha --- - HTML version of this page: https://vulpo.app/integrations/marketplace/macxq-foxess-ha - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml