In breve
Lascia che la tua AI legga il tuo Home Assistant: lo stato attuale di ogni sensore, luce, porta e termostato, la cronologia registrata, il logbook di cosa è successo e quando, e i tuoi calendari. Sola lettura: non controlla mai i dispositivi. Funziona con Home Assistant self-hosted.
Configurazione guidata
Collega Home Assistant a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Home Assistant con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Home Assistant
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Home Assistant, incolla le tue credenziali, genera una chiave API MCP e il gioco è fatto. Niente Docker, niente
git clone, nessun server locale.
Home Assistant
Lascia che la tua AI legga il tuo Home Assistant: lo stato attuale di ogni sensore, luce, porta e termostato, la cronologia registrata, il logbook di cosa è successo e quando, e i tuoi calendari. Sola lettura: non controlla mai i dispositivi. Funziona con Home Assistant self-hosted.
Configurazione
La configurazione richiede circa 3 minuti. Ti serve un'istanza di Home Assistant raggiungibile da AnythingMCP e un token di accesso a lungo termine, idealmente di un utente dedicato senza privilegi di amministratore.
- Imposta
HOME_ASSISTANT_URLsull'indirizzo con cui apri Home Assistant, senza slash finale e senza/api, ad esempiohttps://home.example.comohttp://192.168.1.10:8123(la porta predefinita è 8123). - Consigliato: crea un utente Home Assistant dedicato ad AnythingMCP da Impostazioni → Persone → Utenti → Aggiungi utente, con Amministratore disattivato. Nessuno degli endpoint usati dal connettore richiede i diritti di amministratore.
- Accedi come quell'utente e clicca sul tuo nome in basso a sinistra per aprire il profilo. Apri la scheda Sicurezza e, sotto Token di accesso a lungo termine, clicca su Crea token. Copia il token (viene mostrato una sola volta e resta valido per 10 anni) e incollalo in
HOME_ASSISTANT_TOKEN, senza la parola Bearer. - Installa il connettore ed esegui
home_assistant_get_config: restituisce la versione, il nome della posizione e il fuso orario, e conferma che indirizzo e token funzionano.
Cosa legge: lo stato attuale di ogni entità (sensori, luci, clima, porte, presenza) con i suoi attributi, la cronologia registrata dei valori in un periodo, il logbook di cosa è successo e quando (ad esempio quando si è aperta per l'ultima volta la porta del garage), i tuoi calendari e i relativi eventi, e la configurazione dell'istanza. Gli id delle entità hanno un aspetto come sensor.living_room_temperature o binary_sensor.garage_door.
Sola lettura: ogni tool è una richiesta GET. Il connettore non può richiamare azioni (servizi), accendere o spegnere nulla, sbloccare porte, eseguire script o modificare stati. L'endpoint delle azioni di Home Assistant non è riservato agli amministratori, quindi questa garanzia deriva dal fatto che il connettore espone solo operazioni di lettura, non dal token.
Dove gira Home Assistant: su un AnythingMCP self-hosted, un'istanza su una rete privata (http://192.168.x.x:8123, homeassistant.local) richiede che un amministratore autorizzi l'host in SSRF_ALLOWED_HOSTS o nella allowlist nelle impostazioni di amministrazione. AnythingMCP Cloud può raggiungere solo un'istanza esposta su internet pubblico tramite HTTPS, ad esempio dietro un reverse proxy o tramite l'accesso remoto di Home Assistant Cloud.
Privacy: i dati della casa mostrano chi è in casa e le abitudini quotidiane della famiglia. Assegna il connettore solo a server MCP i cui utenti possono vedere questi dati.
Orari: i timestamp vanno indicati in formato ISO 8601 in UTC con il suffisso Z, ad esempio 2026-10-01T00:00:00Z. home_assistant_get_config restituisce il fuso orario della casa per presentare i risultati.
Errori comuni: 401 significa che il token è errato o è stato eliminato. 404 su una singola entità o sui suoi eventi del calendario significa che nessuna entità ha quell'id; 404 su ogni chiamata significa che HOME_ASSISTANT_URL è errato o termina già con /api. 400 sugli eventi del calendario significa che start o end manca o non è un timestamp valido. Una connessione rifiutata o bloccata significa che l'host non è consentito nella allowlist SSRF (self-hosted) o non è pubblico via HTTPS (Cloud).
Il connettore non richiama azioni o servizi, non scrive né elimina stati, non genera eventi, non renderizza template, non mostra immagini delle telecamere e non legge il flusso di eventi, il log degli errori o l'API WebSocket (aree, dispositivi, registro delle entità).
Prerequisiti: HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN
Installa il connettore in locale
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Apri http://localhost:3000/connectors/store, scegli Home Assistant e incolla le variabili d'ambiente elencate in Prerequisiti.
Strumenti disponibili
| Tool | Cosa fa |
|---|---|
home_assistant_get_config | Ottiene la configurazione di Home Assistant: versione, nome della posizione, fuso orario, sistema di unità, coordinate e componenti caricati |
home_assistant_list_states | Elenca ogni entità che il token può leggere, ridotta a entity_id, stato, nome descrittivo, unità e last_changed |
home_assistant_get_state | Ottiene lo stato attuale di un'entità con tutti i suoi attributi, last_changed e last_updated, ad es. la temperatura target di un termostato o… |
home_assistant_get_history | Ottiene i cambi di stato registrati di una o più entità in un periodo, ad es. la temperatura del soggiorno durante la notte |
home_assistant_get_logbook | Ottiene le voci del logbook a partire da un orario di inizio: eventi leggibili come l'apertura di una porta, l'accensione di una luce o l'arrivo di una persona a casa, con… |
home_assistant_list_calendars | Elenca le entità calendario di questa istanza di Home Assistant (entity_id e nome, ad es. calendar.family) |
home_assistant_get_calendar_events | Ottiene gli eventi di un calendario tra start e end: riepilogo, inizio, fine, descrizione e luogo |
Prossimi passi
Questa guida ti è stata utile?