MMM-AnkerSolixMQTT

A MagicMirror² module that displays real-time power data from the Anker Solix Solarbank 3 E2700 Pro (A17C5) and Anker Smart Meter (A17X7) via MQTT.

Note: This module was developed with the assistance of Claude by Anthropic.

• ⚡ Real-time data updates every ~3 seconds via MQTT
• ☀️ Solar power output (W)
• 🔋 Battery state of charge (%) with charge/discharge power
• 🏠 Power feed into the house (W)
• 💡 Current home consumption (W)
• 🔌 Grid power: import (positive) or export (negative)
• Compact 3×2 tile layout inspired by the Anker app
• 🌍 Multi-language support (de, en, fr, nl, es)

This module requires the Anker Solix API Python library by thomluther:

👉 https://github.com/thomluther/anker-solix-api

The Python poller script (solix_mqtt_poller.py) uses this library to connect to the Anker MQTT cloud server and writes real-time data to a local JSON file, which the MagicMirror module reads.

• Raspberry Pi running MagicMirror²
• Python 3.12 or higher
• Anker account (main account with admin rights — guest accounts do not have MQTT access)
• Anker Solix Solarbank 3 connected together with the Anker Smart Meter in the Anker app

cd ~
git clone https://github.com/thomluther/anker-solix-api.git
cd anker-solix-api

python3 --version

If the output shows Python 3.12 or higher, skip to Step 3.

If the version is below 3.12, you need to install Python 3.12 manually. Raspberry Pi OS Bullseye does not include it in the package manager — try apt first, and if that fails, build from source:

Try apt first (works on Raspberry Pi OS Bookworm):

sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev -y

If apt fails (Raspberry Pi OS Bullseye), build from source (~15–20 minutes):

sudo apt install -y build-essential libssl-dev libffi-dev zlib1g-dev \
  libreadline-dev libsqlite3-dev libbz2-dev libncurses-dev \
  libgdbm-dev liblzma-dev tk-dev wget

cd /tmp
wget https://www.python.org/ftp/python/3.12.9/Python-3.12.9.tgz
tar -xzf Python-3.12.9.tgz
cd Python-3.12.9
./configure --enable-optimizations
make -j$(nproc)
sudo make altinstall

Verify the installation:

python3.12 --version

cd ~/anker-solix-api
python3.12 -m venv venv
source venv/bin/activate
pip install cryptography aiohttp aiofiles paho-mqtt python-dotenv

Create a .env file in the anker-solix-api directory:

nano ~/anker-solix-api/.env

ANKERUSER="your@email.com"
ANKERPASSWORD="yourPassword"
ANKERCOUNTRY="DE"

⚠️ Use your main Anker account (admin). Guest/shared accounts are denied MQTT subscription by the Anker broker.

Run the export tool once to verify your system is detected correctly:

cd ~/anker-solix-api
source venv/bin/activate
python export_system.py

Select all services (a), skip MQTT export for now. Check the exported JSON files to verify your device serial numbers.

cd ~/MagicMirror/modules
git clone https://github.com/utzl/MMM-AnkerSolixMQTT.git

Copy solix_mqtt_poller.py from the cloned module into the anker-solix-api directory:

cp ~/MagicMirror/modules/MMM-AnkerSolixMQTT/solix_mqtt_poller.py \
   ~/anker-solix-api/solix_mqtt_poller.py

Edit the serial numbers at the top of the script to match your devices:

SN_SOLARBANK = "YOUR_SOLARBANK_SERIAL"
SN_SMARTMETER = "YOUR_SMARTMETER_SERIAL"

You can find your serial numbers in the exported JSON files from Step 5, or in the Anker app under device settings.

cd ~/anker-solix-api
source venv/bin/activate
python solix_mqtt_poller.py

You should see real-time output like:

[08:25:03] Authentifiziere...
[08:25:04] Starte MQTT-Session...
[08:25:04] Gerät registriert: AL3DJQD0F52700605
[08:25:04] Gerät registriert: AUJS020F25108568
[08:25:04] Starte message_poller...
[08:25:07] Solar: 1740W | Bat↑: 542W ↓: 0W 99% | Einspeisung: 1198W | Haus: 1809W | Netz: 614W

sudo nano /etc/systemd/system/solix-mqtt-poller.service

[Unit]
Description=Anker Solix MQTT Poller für MagicMirror
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi/anker-solix-api
ExecStart=/home/pi/anker-solix-api/venv/bin/python /home/pi/anker-solix-api/solix_mqtt_poller.py
Restart=always
RestartSec=30

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable solix-mqtt-poller
sudo systemctl start solix-mqtt-poller
sudo systemctl status solix-mqtt-poller

Edit ~/MagicMirror/config/config.js and add:

{
    module: "MMM-AnkerSolixMQTT",
    position: "top_right",
    header: "Anker Solix",
    config: {
        updateInterval: 5000,
        dataFile: "/home/pi/solix_mqtt_data.json"
    }
},

Then restart MagicMirror:

pm2 restart MagicMirror

Anker Devices (Solarbank + Smart Meter)
        ↓  MQTT (~3 seconds)
Anker Cloud MQTT Broker (aiot-mqtt-eu.anker.com)
        ↓
solix_mqtt_poller.py  (Python, runs as systemd service)
        ↓  writes every update
/home/pi/solix_mqtt_data.json
        ↓  reads every 5 seconds
MMM-AnkerSolixMQTT (Node.js / MagicMirror)
        ↓
MagicMirror Display

The poller writes the following fields to the JSON file:

• MQTT requires the main Anker account. Guest or shared accounts are rejected by the Anker MQTT broker with error 128.
• This uses an unofficial API. Anker may change their cloud API or MQTT broker at any time, which could break this module.
• The MQTT real-time trigger times out after 60 seconds of inactivity. The poller handles reconnection automatically via Restart=always in the systemd service.
• At night when there is no solar activity, the Anker devices may send fewer or no MQTT messages. The last known values remain in the JSON file until new data arrives.

• Module developed by utzl with AI-assisted programming by Claude (Anthropic)
• Anker Solix API by thomluther
• Built for MagicMirror²

MIT

The module supports multiple languages and automatically uses the language configured in your MagicMirror config.js:

// In ~/MagicMirror/config/config.js
language: "de",  // de, en, fr, nl, es

The following languages are included:

Translation files are located in the translations/ folder. To add a new language, create a new file (e.g. translations/it.json) using the existing files as a template, and add the language code to the getTranslations() method in MMM-AnkerSolixMQTT.js.

If you find this module useful, consider buying me a coffee — it keeps the project going! ☕