Cielo Home / Mr Cool devices integration for Home Assistant

A Home Assistant custom integration to control Cielo Home devices.

Configuration

This fork adds email / password login — no more extracting tokens from the browser. Setup is just:

1. In Home Assistant go to Settings → Devices & Services → + Add Integration.
2. Search for Cielo Home and select it.
3. Enter the email and password for your Cielo Home / MrCool account.
4. (Optional) leave the two connection-source toggles unchecked unless you know you need them.

That's it. Behind the scenes the integration logs in through Cielo's mobile API endpoint (which, unlike the web login, does not require a reCAPTCHA), obtains the session tokens automatically, and refreshes them as needed.

How it works / notes

• The password is sent as a SHA-256 hash, exactly as the official apps do.
• The websocket sessionId is generated locally (the mobile login does not return one). If live push updates ever stop working, that's the first thing to revisit.
• Two static app API keys are baked in (one for login, one for the /web/* API calls). If Cielo ever rotates them, they'd need updating in const.py.
• If the integration is offline long enough for the refresh token to expire, just reload it (or re-enter your credentials via the integration's options).

Legacy token-based setup (no longer required)

Older versions required pasting access_token, refresh_token, session_id, user_id, and x_api_key extracted from the browser's network log on https://home.cielowigle.com/. The email/password flow above replaces that.

Functionality

You can call the Cielo Sync AC State as a HA service.

A exemple of thermostat card i use : https://github.com/nervetattoo/simple-thermostat

# YAML
- type: custom:simple-thermostat
        entity: climate.basement
        step_size: 1
        layout:
          step: row
          mode:
            names: true
            headings: false
        header: true
        control:
          hvac:
            _name: Mode
          fan:
            _name: Fan Mode
          swing:
            _name: Swing Mode
          preset:
            _name: Preset Mode

Installation

With HACS

Click on the button below to automatically navigate to the repository within HACS:

Alternatively, follow the steps below:

1. Go to HACS "Integrations >" section
2. Click 3 dots in top right
3. Click "Custom repositories"
4. Add repository https://github.com/bodyscape/cielo_home with category Integration
5. In the lower right click "+ Explore & Download repositories"
6. Search for "Cielo Home" and add it

Manual

Copy the cielo_home directory, from custom_components in this repository, and place it inside your Home Assistant Core installation's custom_components directory.

Note: If installing manually, in order to be alerted about new releases, you will need to subscribe to releases from this repository.

Setup

Click on the button below to add the integration:

Alternatively, follow the steps below:

1. Install this integration.
2. Navigate to the Home Assistant Integrations page (Settings --> Devices & Services)
3. Click the + ADD INTEGRATION button in the lower right-hand corner
4. Search for Cielo