shows homeassistant sensors on Magic Mirror
Clone or download
Pull request Compare This branch is 22 commits ahead of tkoeberl:master.


This a module for the MagicMirror. It can display information from Home Assistant using the home assistant REST API.


Navigate into your MagicMirror's modules folder and clone this repository:
cd ~/MagicMirror/modules && git clone

If you want to use icons for the sensors download the MaterialDesignIcons webfont from and unzip the folder:
cd ~/MagicMirror/modules/MMM-homeassistant-sensors && wget && unzip


It is very simple to set up this module, a sample configuration looks like this:

Configuration Options

Option Description
prettyName Pretty print the name of each JSON key (remove camelCase and underscores).

Default: true
stripName Removes all keys before the printed key.

Example: a.b.c will print c.
Default: true
title Title to display at the top of the module.

Default: Home Assistant
host The hostname or ip adress of the home assistant instance.

Default: REQUIRED hassio.local
port port of homeassistant e.g. 443 for SSL.

Default: 8321
https is SSL enabled on home assistant (true/false)

Default: REQUIRED false
token The long lived token.

apipassword Deprecated API password.

Default: ``
updateInterval The time between updates (In milliseconds).

Default: 300000 (5 minutes)
selfsigned allows self signed certificates/ less secure (true/false).

Default: false
debuglogging Enable logging into /home/pi/.pm2/logs/mm-error.log (true/false).

Default: false
values Specify specific values from the json feed to only show what you need (entity_id).

values option

Option Description
sensor entity_id from Home Assistant. Please have a look at the states pages for the unique entity_id of your sensor
icons Icons object for the on/off status of sensor. see: MaterialDesignIcons

icons option

Option Description
default Default icon of the sensor. In case there is no on/off status, like processor use.
state_on On status icon of the sensor
state_off Off status icon of the sensor
state_open Open status icon of the sensor
state_closed Closed status icon of the sensor

Here is an example of an entry in config.js

modules: [{
		module: 'MMM-homeassistant-sensors',
		position: 'top_left',
		config: {
			host: "YOUR_HASS_HOST",
			port: "8123",
			https: false,
			prettyName: false,
			stripName: false,
			debuglogging; false,
			values: [{
					sensor: "sensor.processor_use",
					icons: [{
							"default": "chip"
				}, {
					sensor: "binary_sensor.sensor",
					icons: [{
							"state_off": "run",
							"state_on": "run-fast"
				}, {
					sensor: "switch.reception_spot",
					icons: [{
							"state_off": "lightbulb-outline",
							"state_on": "lightbulb-on-outline"


Result example:

Alt text

Special Thanks

  • Michael Teeuw for creating the awesome MagicMirror2 project that made this module possible.
  • tkoeberl for creating the initial module that I used as guidance in creating this module.