meross-cli

A command-line tool to list devices from Meross and Refoss smart home accounts.

Installation

go build -o meross-cli .

Usage

meross-cli -email <email> -password <password> [options]

Options

Flag	Description
-email	Account email address
-password	Account password
-url	API base URL (see below)
-json	Output in JSON format
-find	Scan LAN for devices after cloud login
-find-range	IP range to scan (default: 192.168.178)

API URLs

Service	Region	URL
Refoss	EU	https://iotx-eu.refoss.net (default)
Refoss	US	https://iotx-us.refoss.net
Meross	Global	https://iotx.meross.com

Examples

List devices (Refoss EU)

./meross-cli -email user@example.com -password mypassword

Logging in as user@example.com...
Login successful!
Fetching devices...

Found 2 device(s):

1. Living Room Plug
   UUID:     2201063512345678901234567890abcd
   Type:     mss310
   Status:   online
   Firmware: 3.2.7
   Hardware: 3.0.0
   Region:   eu
   Domain:   eu-iotx.meross.com
   Key:      abcdef1234567890abcdef1234567890

2. Kitchen Power Strip
   UUID:     2201063587654321098765432109fedc
   Type:     mss425e
   Status:   online
   Firmware: 3.1.4
   Hardware: 2.0.0
   Region:   eu
   Domain:   eu-iotx.meross.com
   Key:      abcdef1234567890abcdef1234567890
   Channels:
     - [1] Coffee Maker
     - [2] Toaster
     - [3] Microwave

JSON output

./meross-cli -email user@example.com -password mypassword -json

[
  {
    "uuid": "2201063512345678901234567890abcd",
    "devName": "Living Room Plug",
    "onlineStatus": 1,
    "fmwareVersion": "3.2.7",
    "hdwareVersion": "3.0.0",
    "deviceType": "mss310",
    "region": "eu",
    "domain": "eu-iotx.meross.com",
    "channels": []
  }
]

Using with Meross account

./meross-cli -email user@example.com -password mypassword -url https://iotx.meross.com

Using with Refoss US account

./meross-cli -email user@example.com -password mypassword -url https://iotx-us.refoss.net

Scan LAN for devices

After cloud login, scan your local network to find device IPs and match them to your cloud account:

./meross-cli -email user@example.com -password mypassword -url https://iotx.meross.com -find

Logging in as user@example.com...
Login successful!
Fetching devices...

Found 2 device(s):
...

Scanning LAN 192.168.178.1-254 for devices...

Found 3 device(s) on LAN:

1. 192.168.178.108
   UUID:     24093082407560510d05c4e7ae0bfa20
   Type:     mss305
   Cloud:    YES (Smart Screen Stube)

2. 192.168.178.112
   UUID:     24093018748822510d05c4e7ae0bf297
   Type:     mss305
   Cloud:    YES (TV Schrank + Router)

3. 192.168.178.62
   UUID:     23080402135087510d0448e1e9d4cd6a
   Cloud:    NO (not in this account)

Use a custom IP range:

./meross-cli -email user@example.com -password mypassword -find -find-range 192.168.1