IVT, Bosch heat pump easy integration, Node-RED

Updated 2026-03-30 !

If you are running the IVT Anywhere or the Bosch Easy remote app you probably also can retrieve its data with for example Node-RED.

With the nice application Bosch XMPP you can set up an integration with the cloud service supplied by your vendor.

Please note !  that this app, 2026-03, doesn't work with Node.js V24 but there is a "work around". Check below.

Prerequisites
I'm using a Raspberry Pi and since the application is using JavaScript you have to install Node.js and in my case Node-RED for displaying the data.

The XMPP protocol, in this case, uses HTTP POST and GET. After some hours of Googling I found some of the root addresses that can be scanned, GET, to find data.

/application

/dhwCircuits

/gateway

/heatingCircuits

/heatSources

/notifications

/solarCircuits

/recordings https://github.com/matsdune/node-red-contrib-bosch-heatpump-decrypt/wiki/Recordings

/system

Installation

Node.js installation is done with (https://nodesource.com/products/distributions)

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

sudo apt install nodejs -y

sudo npm install -g npm@latest

node -v && npm -v

and the actual application 

sudo npm i -g bosch-xmpp

The credentials for the cloud service is made up of 3 parts

--serial=SERIAL          Device serial number (on some devices called "login name")

--access-key=ACCESS_KEY  Device access key (on some devices called "password")

--password=PASSWORD      Device password (on some devices, the user-configured                                                                                 password)

In my case the IP module in the heat pump had a label with information

Loginname:    08nnnnnnn            => --serial

Passwort:     nH3N-xxxx-xxxx-xxxx  => --access-key      

and for the IVT Anywhere app 

Personal password:    nnnnnnnn     => --password

Now you can test if you can access the cloud data using the command line interface(CLI)

bosch-xmpp --serial=08nnnnnnn --access-key=nH3N-xxxx-xxxx-xxxx --password=nnnnnnnnn ivt get /gateway/DateTime

Then use the root addresses above to learn about your device or test out the Node-RED flow below.

Node-RED

Install instructions is found here. 

Instead of using the CLI, above, you can set up the application as a bridge. With command 

bosch-xmpp --serial=08nnnnnnn --access-key=nH3N-xxxx-xxxx-xxxx --password=nnnnnnnnn ivt bridge 3001

which will start up a http server at localhost port 3001. If you want to reach the server from another client just change the tail of the command to ".......ivt bridge 3001 0.0.0.0"

Test it, in another session, with 

curl http://localhost:3001/bridge/gateway/DateTime

import the flow and test with Node-RED and you will get data as picture above.

Remarks

Debug

If you get problem you can execute with 

env DEBUG=* bosch-xmpp .........

Retrieve root addresses

Some devices will accept ".... get /", but didn't work on our IVT pump.

Additional root adresses

The following root addresses were not found on our heat pump but found Googling. 

/devices
/energy

/events

/programs

/zones

/ecus

systemd autostart for the bridge 
If you want to autostart, at boot or at failure, setup the following service. Create a file with 

sudo nano /etc/systemd/system/IVT.service

containing 

[Unit]

Description=IVT bridge server

After=syslog.target network-online.target

[Service]

Type=simple

User=root

ExecStart=/usr/bin/bosch-xmpp --serial=08nnnnnnn --access-key=nH3N-xxxx-xxxx-xxxx --password=nnnnn ivt bridge 3001

Restart=always

RestartSec=10

KillMode=process

[Install]

WantedBy=multi-user.target 

Activate with 

sudo systemctl daemon-reload

and 

sudo systemctl enable IVT && sudo systemctl start IVT

Node V24 workaround

A PR, #52, with a working version is found here https://github.com/stewartmcgown/bosch-xmpp.

Node and NPM install 

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

sudo apt install nodejs -y

sudo npm install -g npm@latest

node -v && npm -v

Uninstall ? 

sudo npm uninstall -g bosch-xmpp

Git

sudo apt install -y git

Bosch-xmpp

sudo npm i -g https://github.com/stewartmcgown/bosch-xmpp

Another way 

npm i -g robertklep/bosch-xmpp#pull/52/head