ZTE Router
Kajkac/ZTE-MC-Home-assistant-repo · v1.0.55
ZTE MC801A, MC888, MC889, G5 Home assistant Custom integration
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
device_tracker | Presence (as an occupancy sensor) |
What people report
ZTE MC-series 5G routers work over the local API, though firmware and region variants need trial and error; the MC889A Pro works by selecting the MC889 profile.
- Works4
- Partly works1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| ZTE G5 Ultra / MC8512 / MC8830 | Works Local | Listed as supportedSaved copySupported devices: Model family; ZTE MC801 / MC801A; ZTE MC888 / MC888A; ZTE MC889 / MC889A; ZTE G5 Ultra and related G5-series units (e.g. MC8512, MC8830 profile). Limitations: Some sensors may briefly show unknown until the next refresh SMS parsing can behave differently across router models/firmware Found something else? Open an issue, reports drive what gets fixed next Excerpt saved from the README on 2026-10-23. | README | |
| ZTE MC801 / MC801A | Works Local | Listed as supportedSaved copySupported devices: Model family; ZTE MC801 / MC801A; ZTE MC888 / MC888A; ZTE MC889 / MC889A; ZTE G5 Ultra and related G5-series units (e.g. MC8512, MC8830 profile). Limitations: Some sensors may briefly show unknown until the next refresh SMS parsing can behave differently across router models/firmware Found something else? Open an issue, reports drive what gets fixed next Excerpt saved from the README on 2026-10-23. | README | |
| ZTE MC888 / MC888A | Works Local | Device tracker and username login added in 2026Saved copy… state handling (`Connected Devices`, `WiFi Clients`, `LAN Clients`) to use computed internal state correctly - Improved client payload normalization in `zteinfo4()` for firmware response variations - Added multi-key extraction fallbacks for MAC/hostname/IP fields - Fixed MC888/MC889 username login routing (router type check used wrong string variants), which could cause authenticated client endpoints to Excerpt saved from GitHub on 2026-10-23. | PR #59 · 2026-03 | |
| ZTE MC889 / MC889A | Works Local | Username login fixed after reportSaved copyI have a ZTE MC889 and it works fine on the following FW: BD_LIVEWIREUKMC889V1.0.0B07 What's the difference between the MC889 and the MC889A? Excerpt saved from GitHub on 2026-10-23. | Issue #21 · 2024-11 | |
| ZTE MC889A Pro | Partly works Local | Works only when MC889 is chosen in setupSaved copyI have for tests MC889A Pro , and till now i use it replacing my MC7010 ( I did it with simplest way , give to MC889A Pro same IP and same password ,with MC7010 had). Integration starts read from new device without any changing. Now i decided to connect it parallel ( using mwan3 on OpenWRT router in balanced mode) , it working properly. ( I changed the IP on MC889A Pro therefore). So decided to Add HUB in integration on HA , put credentials ( pasword same , ip different) , but it is not possible to do it, it shows error. In log i see this: I can see some entities ,but they are unknown: And … Excerpt saved from GitHub on 2026-10-23. | Issue #17 · 2024-09 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Details
| Installs (analytics) | 176 (0.02%) |
|---|---|
| GitHub stars | 58 |
| Latest version | 1.0.55 (2026-08-23) |
| Set up in the UI | Yes |
| Maintainers | @Kajkac |
| License | GPL-3.0 |
Devices listed in its README
- Model family
- ZTE MC801 / MC801A
- ZTE MC888 / MC888A
- ZTE MC889 / MC889A
- ZTE G5 Ultra and related G5-series units (e.g. MC8512, MC8830 profile)
Limitations from the README
- Some sensors may briefly show unknown until the next refresh
- SMS parsing can behave differently across router models/firmware
- Found something else? Open an issue, reports drive what gets fixed next
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
