Back to the overview

MQTT in Home Assistant

mqtt part of Home Assistant since pre 0.7

Local, push Set up in the user interface Quality: Platinum

The MQTT integration connects Home Assistant to MQTT brokers, enabling communication with devices over a local network. It is commonly used for home automation, IoT device control, and sensor data monitoring.

Typical uses

  • Home automation
  • IoT device control
  • sensor monitoring
  • remote control

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, push – Talks to the device on your own network and is told about every change straight away.
Setup
in the user interface
Kind
Online service
Quality scale
Platinum – The highest level: fully typed, efficient and maintained to every rule of the project.
Installations
275,321 (38.3 % of the installations that share statistics)
Categories
Hub, Update
Provides
Alarm control panel, Binary sensor, Button, Camera, Climate, Cover, Date, Date and time, Device tracker, Diagnostics, Event, Fan, Humidifier, Image, Lawn mower, Light, Lock, Notifications, Number, Scene, Select, Sensor, Siren, Switch, Tag scanner, Text, Time, Update, Vacuum, Valve, Water heater
Maintained by
@emontnemery, @jbouwh, @bdraco
Python packages
paho-mqtt==2.1.0

Setup

  1. In Home Assistant open Settings → Devices & services.
  2. Click "Add integration" and search for MQTT.
  3. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Matching add-ons

Add-ons that declare a connection to this integration in their own configuration.

Blueprints that use this integration

  • Automation AWTRIX show entity – Displays entity states on AWTRIX devices using MQTT integration for real-time updates. ♥ 143 · Import · Forum
  • Automation Controller - IKEA E2001/E2002 STYRBAR Remote control – Controls IKEA STYRBAR remote using input text, MQTT, ZHA, or Deconz integrations. ♥ 95 · Import · Forum
  • Automation Zigbee2MQTT - Tuya 4-Button Scene Switch – Handles Tuya 4-button scene switch via MQTT, using sensor entities for input. ♥ 91 · Import · Forum
  • Automation Controller - IKEA E1524/E1810 TRÅDFRI Wireless 5-Button Remote – Controls IKEA TRÅDFRI 5-button remote using input text, MQTT, ZHA, or Deconz integrations. ♥ 78 · Import · Forum
  • Automation Controller - IKEA E1743 TRÅDFRI On/Off Switch & Dimmer – Configures input text for IKEA switch and dimmer control via MQTT, ZHA, and Deconz integrations. ♥ 68 · Import · Forum
  • Automation Controller - IKEA E1744 SYMFONISK Rotary Remote – Uses input text to control IKEA rotary remote via MQTT, ZHA, and Deconz integrations. ♥ 67 · Import · Forum

All blueprints for it

Known issues and fixes

9 open issues and 39 bug fixes in the last twelve months are recorded for MQTT in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.10.2.

Open

  • open Users with Tasmota devices can't decode the payload from the MQTT messages. since April 2, 2026 · 2 reactions · 16 comments · #167165
  • open The MQTT switch's state doesn't update properly even though commands are working. since September 14, 2026 · 0 reactions · 21 comments · #182223
  • open The MQTT integration isn't functioning correctly after an update. since August 22, 2026 · 0 reactions · 9 comments · #179797
  • open MQTT triggers some zigbee2mqtt messages twice, even after a previous fix. since September 15, 2026 · 0 reactions · 6 comments · #182294
  • open The MQTT integration incorrectly reports the host as unavailable. since May 19, 2026 · 0 reactions · 6 comments · #171399
  • open The retain toggle in MQTT automation publish actions is confusing. since May 19, 2026 · 0 reactions · 3 comments · #171422
  • open The lock status for Switch bot devices is displayed incorrectly. Affects: Switch bot since October 14, 2026 · 0 reactions · 2 comments · #186386
  • open Wireless scene switches like Moes and similar devices don't work in actions. Affects: Interruttore di scena wireless Moes e similari since November 1, 2026 · 0 reactions · 1 comment · #189919

Fixed

  • fixed in 2026.10.2 MQTT device triggers and tags now fire once after reloading. Fix #185998
  • fixed in 2026.10.0 MQTT climate setpoints adjust correctly when changing HVAC modes. Fix #184122
  • fixed in 2026.9.4 The entity ID is now logged in MQTT group member update messages. Fix #182928
  • fixed in 2026.8.0 Empty JSON payloads for MQTT IR signals are now ignored without errors. Fix #177664
  • fixed in 2026.6.4 The MQTT discovery option isn't added incorrectly to entry data anymore. Fix #174073
  • fixed in 2026.6.3 User-disabled MQTT entities aren't re-enabled via discovery. Fix #173404
  • fixed in 2026.6.2 Reloading works even if the MQTT entry isn't set up. Fix #173335 · Issue #173169
  • fixed in 2026.6.1 Certificate files are created before migrating the MQTT config entry. Fix #173087 · Issue #173063
  • fixed in 2026.6.1 Value templates in MQTT Fan and Siren setups now work correctly. Fix #172980 · Issue #172922
  • fixed in 2026.6.0 Bug fix #172732 Fix #172732
  • fixed in 2026.6.0 Bug fix #172629 Fix #172629
  • fixed in 2026.6.0 The MQTT protocol setting is now in the main options. Fix #172482

Source: the issue tracker of Home Assistant, as of November 1, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration
The description was written by a language model from the facts listed here, not taken from the documentation.

Scroll to Top