Meross LAN Local-Only Integration Setup

The Meross LAN custom integration controls Meross plugs, switches, and lights over your local network instead of the Meross cloud. It is installed through HACS, and your Meross cloud username and password are used once to recover the device key that authenticates local communication.

Before You Start

Confirm the following before you begin:

1. HACS is installed. If it is not, follow the HACS download guide first.
2. Your Meross devices are set up and working in the Meross app.
3. You have your Meross cloud account username and password available.

Step 1: Install Meross LAN Through HACS

1. In Home Assistant, go to HACS and search for Meross LAN.
2. Select Install on the Meross LAN integration.
3. Restart your Home Assistant instance.

Step 2: Discover Your Devices

Meross devices are typically discovered automatically, and a notification appears when new devices are found.

1. Go to Settings > Devices & Services and look for discovered Meross LAN devices.
2. If a device is not discovered, power cycle it (off for 10 seconds, then on) and check again.
3. To add a device manually, select Add Integration, search for Meross LAN, and enter the device’s IP address or hostname.

Step 3: Recover the Device Key

The device key is a secret stored in your Meross profile that signs messages to the device. When adding a device with an empty or incorrect key, a menu offers two options:

• manually retry entering a different key, or
• recover the key from your Meross account.

If your devices are still paired with the official Meross app, choose to recover the key and sign in with your Meross cloud username and password. Once one device is configured, the key is auto-populated for additional devices.

Step 4: Adjust the Device Options

For each device you can configure:

• Host address: the device IP or hostname. Assign static IP addresses (or DHCP reservations) so devices do not change address.
• Protocol: leave on Auto for automatic HTTP/MQTT switching.
• Polling: defaults to 30 seconds for status updates.