Met een MCP-server geef je Claude rechtstreeks toegang tot je Home Assistant. Je hoeft dan geen YAML meer te kopiëren en plakken: Claude kijkt zelf welke sensoren je hebt, test templates, maakt automations aan en past dashboards aan.

In één avond bouwde ik zo een volledig energie-overzicht. Claude vond mijn meters, ontdekte drie rekenfouten in mijn bestaande sensoren, bouwde ruim dertig nieuwe sensoren, een dashboardtab en een dagelijkse melding, en testte alles voordat het live ging. Daarna ruimde het ook nog de oude, ongebruikte sensoren op. Ik hoefde alleen te vertellen wat ik wilde.

In deze blog lees je hoe je die koppeling maakt, waar je op moet letten en welke prompt je kunt gebruiken om hetzelfde overzicht te laten bouwen.

Hoe het werkt

MCP (Model Context Protocol) is een open standaard waarmee een AI-assistent gereedschap van buitenaf kan gebruiken. De ha-mcp server biedt Claude zo’n honderd tools, zoals “zoek entiteiten”, “test een template” en “maak een automation”.

Schakel Wat het is
Claude De app, in je browser of op je telefoon. Roept de tools aan.
Publieke URL Nabu Casa of een Cloudflare Tunnel, zodat Claude je server kan bereiken
ha-mcp server Draait als app of integratie in Home Assistant en vertaalt de tools naar acties
Home Assistant Je entiteiten, automations, YAML en dashboards

Claude draait in de cloud van Anthropic, ook als je de app op je telefoon gebruikt. Daarom moet de MCP-server via een publieke HTTPS-URL bereikbaar zijn; een adres op je thuisnetwerk werkt niet.

Stap 1: de MCP-server installeren

Je hebt twee keuzes. De makers raden de integratie aan, omdat die op elke Home Assistant-installatie werkt; de app is bijna even goed maar werkt alleen op HA OS en Supervised. Kies er één: twee installaties tegelijk zijn een bekende oorzaak van een hangende verbinding.

Integratie (aanbevolen) App (voorheen add-on)
Werkt op Alle installaties HA OS en Supervised
Installeren via HACS App-winkel
Repository https://github.com/homeassistant-ai/ha-mcp-integration https://github.com/homeassistant-ai/ha-mcp
Token nodig Nee Nee
Waar vind je de URL Configureren-scherm van de integratie Logboek van de app

Route A: de integratie

  1. Open HACS, kies Aangepaste repositories en voeg https://github.com/homeassistant-ai/ha-mcp-integration toe met categorie Integratie.
  2. Installeer HA-MCP Custom Component en herstart Home Assistant.
  3. Ga naar Instellingen → Apparaten & diensten → Integratie toevoegen en kies HA-MCP Server.
  4. Open bij de integratie Configureren. Daar staan je URL’s. De externe ziet eruit als https://<jouw-domein>/api/webhook/<webhook-id>.

Route B: de app

  1. Ga naar Instellingen → Apps → App installeren → ⋮ → Repositories en voeg https://github.com/homeassistant-ai/ha-mcp toe.
  2. Installeer Home Assistant MCP Server en klik op Starten.
  3. Open het tabblad Logboek. Daar staat je URL, in de vorm http://<ip-van-ha>:9583/<geheim-pad>. Die werkt alleen thuis; voor Claude heb je een publieke URL nodig.
  4. Maak hem publiek met de Setup Wizard van ha-mcp. Kies Remote (Internet) en dan Nabu Casa / Webhook Proxy of Cloudflare Tunnel. Met Nabu Casa wordt het iets als https://xxxxx.ui.nabu.casa/api/webhook/mcp_xxxxxxxx.

De Setup Wizard maakt per AI-app de juiste instellingen voor je aan.

Stap 2: koppelen in Claude

In Claude voeg je de server toe als eigen connector. Dat kan op elk abonnement; op Free mag je er één toevoegen.

  1. Open Claude in je browser en ga naar Customize → Connectors.
  2. Klik op + Add en kies Add custom connector.
  3. Geef hem een naam, bijvoorbeeld Home Assistant, en plak je publieke URL uit stap 1.
  4. Klik twee keer op Continue en daarna op Add. Bij een geheime webhook-URL hoef je geen extra inloggegevens in te vullen.
  5. Zet de connector aan in een gesprek via het menu met gereedschappen.

Werk je met Team of Enterprise, dan voegt een eigenaar de connector toe onder Organization settings → Connectors. Daarna klik je zelf op Connect.

Eenmaal toegevoegd werkt de connector overal: in de browser, de desktop-app en de app op je telefoon. Test het met een simpele vraag, zoals “Welke lampen staan er nu aan?”

Veiligheid

De geheime URL is je sleutel: wie hem heeft, kan je huis bedienen. Behandel hem als een wachtwoord.

  • Deel de URL nooit, ook niet in een screenshot of forumpost. Uitgelekt? Maak een nieuwe aan.
  • Inloggen verplichten. Bij de integratie kun je Webhook authentication op ha_auth zetten. Dan is naast de URL ook een Home Assistant-login nodig.
  • Begin met alleen lezen. Met de Read Only Mode kan Claude kijken maar niets wijzigen. Handig om eerst vertrouwen op te bouwen.
  • Bestanden en YAML staan standaard uit. Wil je dat Claude, zoals in mijn energieproject, packages en templatebestanden schrijft? Zet dan de beta-functies en de File & YAML-tools aan in het HA-MCP-paneel.
  • Laat Claude om bevestiging vragen. In Claude kun je per tool instellen of hij eerst toestemming vraagt. Doe dat voor alles wat schrijft of verwijdert.
  • Back-ups. ha-mcp maakt automatisch een back-up van wat het aanpast. Bij grotere klussen, zoals opruimen, liet ik Claude vooraf ook een volledige Home Assistant-back-up maken.

De prompt voor het energie-overzicht

Met deze prompt bouwt Claude hetzelfde overzicht in jouw Home Assistant. Hij werkt ook met andere meters en leveranciers: Claude zoekt zelf de juiste sensoren op. Pas de punten tussen haakjes aan. Liever zelf bouwen? In de energie-blog staat alle code stap voor stap.

Ik wil een eerlijk energie-overzicht in Home Assistant. Gebruik de Home Assistant-connector.

Doel: per dag, maand en jaar zien
- wat ik van het net haalde en wat dat kostte
- wat ik terugleverde en wat dat opbracht
- wat mijn zonnepanelen opleverden
- wat ik aan gas verbruikte en wat dat kostte
- wat slim laden met de batterij opleverde
- wat ik in totaal bespaar, en wat ik zonder zon en batterij betaald zou hebben

Rekenregels:
- Reken elke kWh tegen de all-in prijs (incl. belasting) van dat moment. Mijn leverancier is [Zonneplan] en rekent per [kwartier of uur]. Neem ook [gas] mee, met de gasprijs van die dag.
- Gebruik de oplopende kWh-meterstanden (P1, omvormer, batterij), niet vermogen in watt.
- Batterij: ontladen min laden, allebei tegen de netprijs van dat moment.
- Netto betaald = afname min teruglevering. Tel de batterij hier niet nog eens af.
- Bedragen moeten ook omlaag kunnen (laden, negatieve prijzen). Gebruik daarom geen utility_meter op een bedrag.
- Ga uit van salderen (teruglevering = afnameprijs), tot 1 januari 2027.

Werkwijze:
1. Zoek eerst welke meters en prijssensor ik heb en laat zien wat je gaat gebruiken.
2. Controleer mijn bestaande energie-sensoren en vertel me wat daaraan niet klopt. Pas ze niet aan.
3. Test je templates met voorbeeldwaarden voordat je iets aanmaakt.
4. Zet alles in één package in de map packages/ en een herbruikbare macro, met vaste entity-id's.
5. Maak een dashboardtab [Energie-overzicht] met drie blokken: vandaag, deze maand, dit jaar.
6. Maak een avondmelding om [23:55] naar [mijn telefoon] met de cijfers van vandaag en de besparing van deze maand.
7. Controleer na een paar minuten of de bedragen goed oplopen, ook of dag, maand en jaar gelijk lopen.

Vraag me om bevestiging voordat je bestanden schrijft of Home Assistant herlaadt.

De prompt werkt het best als Claude schrijfrechten heeft op packages en custom_templates (zie Veiligheid). Zonder die rechten levert Claude de YAML aan en zet jij hem zelf neer.

Tips voor goede prompts

Het grootste verschil maak je door te zeggen wat je wilt zien, niet hoe Claude het moet bouwen.

  • Begin open. “Kijk wat ik in Home Assistant heb en doe drie voorstellen” levert vaak betere ideeën op dan een kant-en-klare opdracht.
  • Vraag eerst om een controle. Laat Claude bestaande sensoren nalopen voordat hij iets nieuws bouwt. Bij mij kwamen zo drie rekenfouten boven.
  • Eis een test. Laat templates eerst met voorbeeldwaarden testen en de melding één keer versturen.
  • Zeg hoe precies het moet zijn. “Het moet op de cent kloppen” leidde tot rekenen met meterstanden in plaats van vermogen.
  • Werk in kleine stappen. Eerst de melding, dan de sensoren, dan het dashboard. Na elke stap zie je het resultaat en kun je bijsturen.
  • Laat een testtab gebruiken. Bouw nieuwe kaarten eerst in een apart tabblad en verplaats ze pas als je tevreden bent.
  • Vraag om opruimen. “Welke helpers worden nergens meer gebruikt?” levert een nette lijst op, met per sensor waar hij wel of niet gebruikt wordt.

Meer lezen

Lees ook

  1. Een eerlijk energie-overzicht in Home Assistant: wat kosten stroom en gas echt?

    Per dag, maand en jaar zien wat je van het net haalt, wat je teruglevert, wat gas kost, wat zon en slim laden opleveren en wat je bespaart. Elke kWh en m³ tegen de prijs van dat moment. Stap voor stap, ook als je net begint.24 oktober 2026, 44 minuten lezen

  2. Een wandtablet als Home Assistant-dashboard: Fully Kiosk, WallPanel en slim laden

    Een Android-tablet aan de muur als bedieningspaneel: een dashboard met agenda, weer en energie, een fotoscreensaver met klok en meldingen, de beveiligingsapp met één knop, en een slimme stekker die de accu tussen 15% en 90% houdt.22 oktober 2026, 14 minuten lezen

  3. Thuisbatterij slim laden 2.0: goedkoop laden, sparen voor de dure uren

    Een verbeterde aanpak voor een Marstek-thuisbatterij met Home Assistant en Zonneplan. Laden in de goedkoopste uren van de dag met ruimte voor de zon, en de lading bewaren voor de duurste uren. Stap voor stap, ook als je net begint.27 oktober 2026, 36 minuten lezen