Home Assistant (ha-mcp)
Server MCP di homeassistant-ai
Controlla e configura dispositivi, stati, automazioni, script e dashboard di Home Assistant in linguaggio naturale.
Installa Home Assistant (ha-mcp)
Gira sul tuo computer. Il tuo client lo avvia con questo comando:
Richiede uv (Python) sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.
HOMEASSISTANT_URLYour Home Assistant URL.HOMEASSISTANT_TOKENsegreto Home Assistant long-lived access token.
Condividi questo server
Apre questa pagina, con il comando di installazione e i passaggi di configurazione.
mcp.tc/i/home-assistantDescrizione
Un server non ufficiale, creato dalla community, che collega un assistente AI a un’istanza di Home Assistant. Ti permette di controllare i dispositivi della smart home, interrogare gli stati delle entità, richiamare servizi e gestire automazioni, script e dashboard usando il linguaggio naturale.
Può essere eseguito come componente personalizzato di Home Assistant installato tramite HACS, come app di Home Assistant (add-on), in Docker oppure in locale con uvx ha-mcp@latest. Il componente e l’app usano Streamable HTTP e non richiedono token di accesso. Le configurazioni Docker e uvx richiedono HOMEASSISTANT_URL e un token di accesso di lunga durata in HOMEASSISTANT_TOKEN. Il trasporto stdio è documentato come affetto da problemi noti.
Cosa puoi fare
- Controllare i dispositivi della smart home e richiamare i servizi di Home Assistant
- Interrogare gli stati delle entità
- Gestire automazioni e script
- Configurare le dashboard
- Eseguire come componente personalizzato HACS, app, Docker o pacchetto uvx
- Autenticazione OIDC facoltativa per l’accesso remoto
Tool
Home Assistant (ha-mcp) mostra i suoi tool solo ai client con una chiave, quindi non possiamo elencarli qui.
Prompt di esempio
Spegni tutte le luci del soggiorno
Qual è la temperatura attuale in camera da letto?
Crea un’automazione che accenda la luce del portico al tramonto
Elenca le mie automazioni e dimmi quali sono disattivate
Configurazione
Ogni client avvia Home Assistant (ha-mcp) sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.
Claude Code
- Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio home-assistant --env "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" --env "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" -- uvx ha-mcp@latest- Avvia Claude Code e digita
/mcp. home-assistant dovrebbe risultare collegato.
Aggiungi --scope user per renderlo disponibile in tutti i progetti. Sostituisci i segnaposto con i tuoi valori.
Claude Desktop
- Apri Settings → Developer → Edit Config. Si apre
claude_desktop_config.json. Aggiungi:
{
"mcpServers": {
"home-assistant": {
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
}
}
}
}- Salva il file e riavvia Claude Desktop. Sostituisci i segnaposto con i tuoi valori.
Richiede uv (Python) sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.
Cursor
Aggiungi a Cursor (si apre in una nuova scheda)
Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):
{
"mcpServers": {
"home-assistant": {
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
}
}
}
}Richiede uv (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
VS Code
Aggiungilo a .vscode/mcp.json. VS Code chiede il segreto la prima volta e lo conserva in modo sicuro:
{
"servers": {
"home-assistant": {
"type": "stdio",
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "${input:homeassistant-token}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "homeassistant-token",
"description": "HOMEASSISTANT_TOKEN",
"password": true
}
]
}Richiede uv (Python) sul tuo computer.
Devin Desktop
- Aggiungilo a
~/.config/devin/mcp_config.json(macOS e Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"home-assistant": {
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
}
}
}
}- Aggiorna l’elenco dei server MCP in Cascade. Sostituisci i segnaposto con i tuoi valori.
Devin Desktop è il nuovo nome di Windsurf.
Codex
codex mcp add home-assistant --env "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" --env "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" -- uvx ha-mcp@latestOppure modifica direttamente ~/.codex/config.toml:
[mcp_servers.home-assistant]
command = "uvx"
args = ["ha-mcp@latest"]
env = { HOMEASSISTANT_URL = "<YOUR_HOMEASSISTANT_URL>", HOMEASSISTANT_TOKEN = "<YOUR_HOMEASSISTANT_TOKEN>" }Richiede uv (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
Gemini CLI
gemini mcp add -e "HOMEASSISTANT_URL=<YOUR_HOMEASSISTANT_URL>" -e "HOMEASSISTANT_TOKEN=<YOUR_HOMEASSISTANT_TOKEN>" home-assistant uvx ha-mcp@latestCosì lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.
Qualsiasi client
La maggior parte dei client che avviano server locali accetta questa forma:
{
"mcpServers": {
"home-assistant": {
"command": "uvx",
"args": [
"ha-mcp@latest"
],
"env": {
"HOMEASSISTANT_URL": "<YOUR_HOMEASSISTANT_URL>",
"HOMEASSISTANT_TOKEN": "<YOUR_HOMEASSISTANT_TOKEN>"
}
}
}
}Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.
Richiede uv (Python) sul tuo computer. Sostituisci i segnaposto con i tuoi valori.
Embed
Mostra Home Assistant (ha-mcp) in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed
Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.
Badge per il README
[](https://mcp.tc/i/home-assistant)<a href="https://mcp.tc/i/home-assistant"><img src="https://mcp.tc/i/home-assistant/badge.svg" alt="Home Assistant (ha-mcp) on mcp.tc" height="20"></a>Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.
Card per il sito
<script src="https://mcp.tc/w/home-assistant.js" async></script>La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.
iframe
<iframe src="https://mcp.tc/embed/home-assistant" title="Home Assistant (ha-mcp) on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.
JSON
La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).
https://mcp.tc/i/home-assistant.jsonPrompt per l’AI
Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di Home Assistant (ha-mcp) al tuo sito.
Aggiungi al mio sito la card di mcp.tc per Home Assistant (ha-mcp), un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.
Metti questo tag dove deve comparire la card. La card appare subito prima del tag:
```html
<script src="https://mcp.tc/w/home-assistant.js" async></script>
```
Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.
```html
<div data-mcptc="home-assistant"><a href="https://mcp.tc/i/home-assistant">Home Assistant (ha-mcp) on mcp.tc</a></div>
```
Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.
Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).
Per un README o altra documentazione in Markdown, usa invece il badge:
```markdown
[](https://mcp.tc/i/home-assistant)
```
Riferimento: https://mcp.tc/it/embedCronologia delle modifiche
Questo server gira sul tuo computer, quindi seguiamo il suo pacchetto PyPI: qui compare ogni nuova versione, insieme alle modifiche di chi lo gestisce.
-
Nuova versione 9.2.0 (prima 9.1.2). Letta da PyPI.
-
Nuova versione 9.1.2 (prima 9.1.1). Letta da PyPI.
-
Nuova versione 9.1.1 (prima 9.1.0). Letta da PyPI.
-
Nuova versione 9.1.0 (prima 9.0.0). Letta da PyPI.
-
Nuova versione 9.0.0 (prima 8.7.0). Letta da PyPI.
-
Nuova versione 8.7.0 (prima 8.6.0). Letta da PyPI.
-
Inizio del tracciamento: versione 8.6.0.
Domande frequenti
Posso incollare mcp.tc/i/home-assistant nel mio client MCP?
No. Home Assistant (ha-mcp) gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è uvx ha-mcp@latest.
Home Assistant (ha-mcp) richiede una chiave API?
Sì. Legge HOMEASSISTANT_URL e HOMEASSISTANT_TOKEN dal suo ambiente, e HOMEASSISTANT_TOKEN è un segreto. Metti il valore nella configurazione del tuo client sul tuo computer, mai in un file condiviso.
Home Assistant (ha-mcp) è un server remoto o locale?
Locale. Il tuo client lo avvia come processo sul tuo computer con uvx ha-mcp@latest, che richiede uv (Python).
Cosa può fare Home Assistant (ha-mcp)?
Puoi controllare i dispositivi della smart home e richiamare i servizi di Home Assistant, interrogare gli stati delle entità e gestire automazioni e script.
Quali client possono usarlo?
Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.
mcp.tc tiene traccia delle modifiche di Home Assistant (ha-mcp)?
In parte. Gira sul tuo computer, quindi seguiamo il suo pacchetto PyPI: la sua sezione Cronologia mostra ogni nuova versione e le modifiche di chi lo gestisce. Segui la scheda per ricevere un’email quando cambia.
Chi ha scritto questa pagina?
Il robot di mcp.tc ha letto i metadati pubblici di Home Assistant (ha-mcp) (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina. Questa traduzione è stata fatta da un modello di AI a partire dal testo inglese.
mcp.tc non è affiliato a homeassistant-ai. Questa pagina è stata creata a partire dai metadati pubblici di Home Assistant (ha-mcp) (ultimo controllo: 3 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda. La traduzione è stata fatta da un modello di AI a partire dal testo inglese.