From 6d0b014ee955ab7070326a1482e00b7a62f8601e Mon Sep 17 00:00:00 2001
From: Alexandre <44178713+alexbelgium@users.noreply.github.com>
Date: Mon, 22 Jun 2026 08:34:54 +0200
Subject: [PATCH] Update HAINTEGRATION.md

---
 birdnet-go/HAINTEGRATION.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/birdnet-go/HAINTEGRATION.md b/birdnet-go/HAINTEGRATION.md
index be6e3d06f9..aaa01f7b4a 100644
--- a/birdnet-go/HAINTEGRATION.md
+++ b/birdnet-go/HAINTEGRATION.md
@@ -2,6 +2,15 @@
 
 BirdNET-Go can be integrated with Home Assistant using a MQTT Broker.
 
+> **💡 Easiest path — automatic discovery.** If you run the Home Assistant
+> Mosquitto (MQTT) addon, just set `mqtt_auto_config: true` in this add-on's
+> options. The add-on then wires in the broker credentials **and** enables
+> BirdNET-Go's native Home Assistant MQTT auto-discovery, so the detection
+> sensors appear in Home Assistant automatically with **no manual YAML at
+> all**. The manual sensor/template/card configuration below is only needed if
+> you want to build your own custom entities instead of (or in addition to) the
+> auto-discovered ones.
+
 ## MQTT Configuration
 
 Your Home Assistant must be setup with MQTT and BirdNET-Go MQTT integration must be enabled. Modify the BirdNET-Go config.yaml file to enable MQTT. If you are using the Mosquitto Broker addon, you will see a log message during the BirdNET-Go startup showing the internal MQTT server details needed for configuration similar to below.