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 between devices over a local network. It is commonly used for home automation, sensor monitoring, and integrating IoT devices into smart home systems.

Typical uses

  • Controlling smart home devices
  • Monitoring sensors
  • Automating scenes
  • Integrating IoT devices

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
263,552 (38.6 % 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, Infrared, 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 ♥ 143 · Import · Forum
  • Automation Controller - IKEA E2001/E2002 STYRBAR Remote control ♥ 95 · Import · Forum
  • Automation Zigbee2MQTT - Tuya 4-Button Scene Switch ♥ 91 · Import · Forum
  • Automation Controller - IKEA E1524/E1810 TRÅDFRI Wireless 5-Button Remote ♥ 78 · Import · Forum
  • Automation Controller - IKEA E1743 TRÅDFRI On/Off Switch & Dimmer ♥ 68 · Import · Forum
  • Automation Controller - IKEA E1744 SYMFONISK Rotary Remote ♥ 67 · Import · Forum

All blueprints for it

Known issues and fixes

5 open issues and 31 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.8.0.

Open

  • open The MQTT integration cannot properly decode messages from Tasmota devices. since April 2, 2026 · 2 reactions · 16 comments · #167165
  • open Vacuum area mappings created via MQTT-based vacuums do not get removed when no longer needed. since July 2, 2026 · 1 reaction · 7 comments · #175326
  • open The MQTT integration incorrectly reports that the host is unavailable. since May 19, 2026 · 0 reactions · 6 comments · #171399
  • open The MQTT retain toggle in automation settings is misleading about its behavior. since May 19, 2026 · 0 reactions · 3 comments · #171422
  • open The MQTT integration sets an incorrect attribute for device tracker location names. since May 28, 2026 · 0 reactions · 1 comment · #172435

Fixed

  • fixed in 2026.8.0 The MQTT integration now ignores empty JSON strings for IR signal payloads instead of causing errors. Fix #177664
  • fixed in 2026.6.4 The MQTT discovery option was incorrectly added to entry data and has been removed. Fix #174073
  • fixed in 2026.6.3 MQTT entities discovered through MQTT are no longer enabled if the user has disabled them manually. Fix #173404
  • fixed in 2026.6.2 Reloading MQTT configurations now works even if the MQTT entry was not initially set up. Fix #173335 · Issue #173169
  • fixed in 2026.6.1 Certificate files are now created before attempting to migrate MQTT configuration entries. Fix #173087 · Issue #173063
  • fixed in 2026.6.1 The MQTT integration now correctly handles value templates for fan and siren subentries. Fix #172980 · Issue #172922
  • fixed in 2026.6.0 The MQTT device tracker now logs attributes in the correct order. Fix #172732
  • fixed in 2026.6.0 The MQTT device tracker now saves state changes when location accuracy updates occur. Fix #172629
  • fixed in 2026.6.0 The MQTT protocol setting has been moved to the main configuration options. Fix #172482
  • fixed in 2026.6.0 MQTT valve states are now reset correctly when positioned at intermediate points. Fix #165176
  • fixed in 2026.5.2 MQTT device settings are now properly recalled when reconfiguring devices. Fix #170484
  • fixed in 2026.5.2 MQTT device discovery now uses shared QoS and encoding options as intended. Fix #170195 · Issue #170166

Source: the issue tracker of Home Assistant, as of September 13, 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