Collegare Home Assistant MCP a Gemini CLI

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca Connectors → Home Assistant, incolla le tue credenziali, genera una chiave API MCP — fatto. Niente Docker, niente git clone, nessun server locale.

Home Assistant + Gemini

Lascia che la tua AI legga il tuo Home Assistant: lo stato attuale di ogni sensore, luce, porta e termostato, la cronologia registrata, il registro di cosa è successo e quando, e i tuoi calendari. Sola lettura: non controlla mai i dispositivi. Funziona con Home Assistant self-hosted.

Prerequisiti

Consulta le istruzioni di configurazione complete incluse nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN

Passaggio 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti serve un'istanza di Home Assistant raggiungibile da AnythingMCP e un token di accesso di lunga durata, idealmente di un utente dedicato senza privilegi di amministratore.

1. Imposta HOME_ASSISTANT_URL sull'indirizzo con cui apri Home Assistant, senza slash finale e senza /api, per esempio https://home.example.com o http://192.168.1.10:8123 (la porta predefinita è 8123).
2. Consigliato: crea un utente Home Assistant dedicato per AnythingMCP in Impostazioni → Persone → Utenti → Aggiungi utente, con Amministratore disattivato. Nessuno degli endpoint usati dal connettore richiede diritti di amministratore.
3. 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 di lunga durata, clicca 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.
4. 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 registro di cosa è successo e quando (per esempio quando si è aperta l'ultima volta la porta del garage), i tuoi calendari e i relativi eventi, e la configurazione dell'istanza. Gli id delle entità hanno la forma sensor.living_room_temperature o binary_sensor.garage_door.

Sola lettura: ogni tool è una richiesta GET. Il connettore non può chiamare 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 letture, non dal token.

Dove gira Home Assistant: su un AnythingMCP self-hosted, un'istanza in una rete privata (http://192.168.x.x:8123, homeassistant.local) richiede che un amministratore consenta l'host in SSRF_ALLOWED_HOSTS o nella allowlist delle impostazioni di amministrazione. AnythingMCP Cloud può raggiungere solo un'istanza esposta su internet pubblico tramite HTTPS, per esempio dietro un reverse proxy o con l'accesso remoto di Home Assistant Cloud.

Privacy: i dati della casa mostrano chi è presente 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 suffisso Z, per 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 è sbagliato 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 è sbagliato 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 chiama 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 né l'API WebSocket (aree, dispositivi, registro delle entità).

Passaggio 2 — Installa l'adapter

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

Passaggio 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Home Assistant.

Tool disponibili

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT