{"id":33535006,"url":"https://github.com/andrew-blake/melcloudhome","last_synced_at":"2026-04-12T23:58:23.832Z","repository":{"id":325918027,"uuid":"1097503957","full_name":"andrew-blake/melcloudhome","owner":"andrew-blake","description":"Melcloudhome Home Assistant Integration","archived":false,"fork":false,"pushed_at":"2026-01-19T16:09:07.000Z","size":1765,"stargazers_count":31,"open_issues_count":5,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-01-19T22:40:36.483Z","etag":null,"topics":["climate-control","hacs","home-assistant","home-assistant-integration","hvac","melcloud","mitsubishi-electric"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrew-blake.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORTED_DEVICES.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-16T10:05:47.000Z","updated_at":"2026-01-14T19:08:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/andrew-blake/melcloudhome","commit_stats":null,"previous_names":["andrew-blake/melcloudhome"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/andrew-blake/melcloudhome","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-blake%2Fmelcloudhome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-blake%2Fmelcloudhome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-blake%2Fmelcloudhome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-blake%2Fmelcloudhome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrew-blake","download_url":"https://codeload.github.com/andrew-blake/melcloudhome/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrew-blake%2Fmelcloudhome/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28752671,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T10:25:12.305Z","status":"ssl_error","status_checked_at":"2026-01-25T10:25:11.933Z","response_time":113,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["climate-control","hacs","home-assistant","home-assistant-integration","hvac","melcloud","mitsubishi-electric"],"created_at":"2025-11-26T20:01:05.868Z","updated_at":"2026-04-12T23:58:23.813Z","avatar_url":"https://github.com/andrew-blake.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MELCloud Home\n\n[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/custom-components/hacs)\n[![GitHub Release](https://img.shields.io/github/release/andrew-blake/melcloudhome.svg)](https://github.com/andrew-blake/melcloudhome/releases)\n![License](https://img.shields.io/github/license/andrew-blake/melcloudhome.svg)\n[![Test](https://github.com/andrew-blake/melcloudhome/workflows/Test/badge.svg)](https://github.com/andrew-blake/melcloudhome/actions/workflows/test.yml)\n[![codecov](https://codecov.io/gh/andrew-blake/melcloudhome/graph/badge.svg?token=WW97CHORNS)](https://codecov.io/gh/andrew-blake/melcloudhome)\n[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)\n![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fandrew-blake%2Fmelcloudhome%2Fmain%2Fpyproject.toml)\n\nHome Assistant custom integration for **MELCloud Home**.\n\n## What's New in v2.3.0\n\nMigrated to the mobile BFF API with OAuth 2.0 PKCE authentication, resolving the MELCloud service outage. Existing users will be automatically migrated on upgrade. Now available in 10 languages with French and Turkish added. See [CHANGELOG.md](CHANGELOG.md) for full history.\n\n## Features\n\n### Air-to-Air (ATA) - Air Conditioning\n\n- Full climate control (power, temperature, modes, fan speeds, vane directions)\n- Energy monitoring with Home Assistant Energy Dashboard support\n- Real-time sensors (room temperature, outdoor temperature*, WiFi signal, connection status)\n- 60-second polling for climate updates, 30-minute for outdoor temperature\n\n*Auto-detected from device capabilities - not all units have outdoor temperature sensors\n\n### Air-to-Water (ATW) - Heat Pumps\n\n- Zone 1 \u0026 Zone 2 climate control with preset modes (Room/Flow/Curve) - Zone 2 auto-detected\n- DHW tank control via water heater platform\n- System power switch\n- Multiple sensors (temperatures, operation status, 6 telemetry sensors)\n- Energy monitoring* (consumed, produced, COP - Energy Dashboard compatible)\n- Cooling mode* (Cool Room/Cool Flow presets)\n\n*Auto-detected from device capabilities - see [docs/entities.md](docs/entities.md) for details\n\n## Requirements\n\n- Home Assistant 2024.11.0 or newer\n- MELCloud Home account with configured devices\n- Internet connection for cloud API access\n\n## Supported Devices\n\n### Air-to-Air (ATA) - Air Conditioning Units\n\nThis integration supports Mitsubishi Electric air conditioning units connected via **MELCloud Home** WiFi adapters (MAC-5xx series).\n\n**Supported systems:** Wall-mounted splits, ducted systems, and console units tested and working.\n\n\u003e **Note:** If your system uses the classic **MELCloud** app (not MELCloud Home), use the official Home Assistant MELCloud integration instead.\n\nFor complete hardware compatibility including specific models, WiFi adapters, and technical notes, see [SUPPORTED_DEVICES.md](SUPPORTED_DEVICES.md).\n\n### Air-to-Water (ATW) - Heat Pumps\n\n- **Status:** Production-ready (tested on real hardware)\n- **Supported systems:** Mitsubishi Electric Ecodan heat pumps with FTC controllers\n- **Core features:** Zone 1 \u0026 Zone 2 heating, DHW control, 3-way valve systems, telemetry sensors, energy monitoring*\n- **Optional features:** Cooling mode (capability-based), energy monitoring (capability-based)\n\n*Feature availability auto-detected from device capabilities\n\nFor tested controller models and capability details, see [SUPPORTED_DEVICES.md](SUPPORTED_DEVICES.md).\n\n## Installation\n\n### HACS (Recommended)\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=andrew-blake\u0026repository=melcloudhome\u0026category=integration)\n\nOr manually: HACS → Integrations → ⋮ → Custom repositories → add `https://github.com/andrew-blake/melcloudhome`\n\nAfter adding, find \"MELCloud Home\" in HACS, click \"Download\", and restart Home Assistant.\n\n### Manual Installation\n\n1. Download the latest release from [GitHub](https://github.com/andrew-blake/melcloudhome/releases)\n2. Extract the `melcloudhome` folder to your `custom_components` directory\n3. Restart Home Assistant\n\n## Configuration\n\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=melcloudhome)\n\nOr manually: **Settings** → **Devices \u0026 Services** → **Add Integration** → search \"MELCloud Home\"\n\nEnter your MELCloud Home credentials (email and password). Your devices will be automatically discovered and added.\n\n## Important Notes\n\n### Stable Entity IDs\n\nThis integration uses **UUID-based entity IDs** to ensure automations never break when device names change. Entity IDs follow the format `{domain}.melcloudhome_{short_id}_{entity_name}` where `short_id` is derived from the device UUID.\n\n**Device names** are set to friendly names from your MELCloud Home account (e.g., \"Living Room\").\n\n**⚠️ Warning:** If you delete entities and use the \"Recreate entity IDs\" option, entity IDs will change to name-based IDs (e.g., `climate.living_room_climate`), breaking automations. To preserve IDs, delete and re-add the integration instead.\n\nSee [docs/entities.md](docs/entities.md) for complete entity ID reference.\n\n## Entities\n\nThe integration creates the following entities for each device:\n\n**Air-to-Air (ATA) Systems:**\n\n- Climate control (HVAC modes, temperature, fan speeds, swing)\n- Sensors (room temperature, outdoor temperature*, WiFi signal, energy consumption)\n- Binary sensors (error state, connection status)\n\n**Air-to-Water (ATW) Heat Pumps:**\n\n- Climate control (Zone 1 \u0026 Zone 2 heating/cooling with preset modes)\n- Water heater (DHW tank control)\n- System power switch\n- Sensors (temperatures, operation status, telemetry, WiFi signal, energy*)\n- Binary sensors (error state, connection status, forced DHW active)\n\n*Energy monitoring auto-detected from device capabilities\n\n**Complete entity reference:** See [docs/entities.md](docs/entities.md) for detailed entity IDs, control options, and configuration examples.\n\n## Troubleshooting\n\n### Integration Not Loading\n\n- Check Home Assistant logs for errors\n- Verify your MELCloud Home credentials\n- Ensure devices are configured in the MELCloud Home app\n\n### Entities Not Updating\n\n- Check your internet connection\n- Verify MELCloud Home service is accessible\n- Review the integration logs for API errors\n\n### Energy Sensor Unavailable\n\n- Some devices may not report energy data\n- Check if device shows energy consumption in the MELCloud Home app\n- Energy sensors require 30 minutes for initial data\n\n### Export Diagnostics\n\n1. Go to **Settings** → **Devices \u0026 Services**\n2. Find \"MELCloud Home\" integration\n3. Click the three dots and select \"Download diagnostics\"\n4. Share the file when reporting issues\n\n## API Rate Limiting\n\nThe integration uses conservative polling intervals to respect API limits:\n\n- **Climate/Sensors**: 60 seconds\n- **Energy Data**: 30 minutes\n- **Outdoor Temperature**: 30 minutes\n\nThese intervals balance update frequency with API rate limits.\n\n## Development \u0026 Code Quality\n\n[![Coverage Sunburst](https://codecov.io/gh/andrew-blake/melcloudhome/graphs/sunburst.svg?token=WW97CHORNS)](https://codecov.io/gh/andrew-blake/melcloudhome)\n\n**Test Coverage:**\n\n- Integration tests: Climate control, sensors, config flow, diagnostics\n- API tests: Authentication, device control, data parsing\n- Quality gates: All PRs require passing tests and coverage checks\n\n**Documentation:**\n\n- [Architecture Overview](docs/architecture.md) - Visual system architecture with mermaid diagrams\n- [Testing Best Practices](docs/testing-best-practices.md) - Development setup and testing guidelines\n- [Architecture Decision Records](docs/README.md#architecture-decision-records-adrs) - Key architectural decisions (ADR-001 through ADR-016)\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/andrew-blake/melcloudhome/issues)\n- **Documentation**: [GitHub Repository](https://github.com/andrew-blake/melcloudhome)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Disclaimer\n\nThis is an unofficial integration and is not affiliated with, endorsed by, or connected to Mitsubishi Electric or MELCloud. Use at your own risk.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=andrew-blake/melcloudhome\u0026type=timeline\u0026legend=bottom-right)](https://www.star-history.com/#andrew-blake/melcloudhome\u0026type=timeline\u0026legend=bottom-right)\n\n## Credits\n\nDeveloped by Andrew Blake ([@andrew-blake](https://github.com/andrew-blake))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrew-blake%2Fmelcloudhome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrew-blake%2Fmelcloudhome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrew-blake%2Fmelcloudhome/lists"}