Invite Calendar: Trasforma la tua casella email in un calendario per Home Assistant

Per chi utilizza home Assistant e necessita di una gestione più avanzata dei calendari, arriva una soluzione innovativa: Invite Calendar. Questo nuovo componente personalizzato permette di trasformare una semplice casella di posta elettronica in una fonte dinamica per il proprio calendario, integrandosi perfettamente con Home Assistant. L'obiettivo è superare i limiti del calendario nativo della piattaforma, offrendo una maggiore flessibilità nella gestione degli eventi, specialmente per chi utilizza sistemi come Nextcloud per la sincronizzazione dei propri appuntamenti. L'integrazione di Invite Calendar Home Assistant semplifica notevolmente questo processo.

Cos'è Invite Calendar e come funziona

Invite Calendar non è un client CalDAV generico, poiché Home Assistant dispone già di un'integrazione nativa per la lettura di questi calendari. La sua peculiarità risiede nella capacità di leggere gli inviti di calendario (richieste e cancellazioni) direttamente da una casella email IMAP. Questi inviti vengono poi elaborati e possono essere memorizzati localmente in un file .ics o sincronizzati con un calendario CalDAV esistente, come quello di Nextcloud. Gli eventi creati manualmente nel calendario CalDAV vengono visualizzati ma non modificati dal componente, garantendo l'integrità dei dati.

Funzionalità principali di Invite Calendar

Le funzionalità offerte da Invite Calendar sono molteplici e pensate per un'automazione avanzata:

• Lettura inviti email: Acquisisce richieste e cancellazioni di eventi da una casella IMAP, gestendo anche serie ricorrenti e modifiche a singole occorrenze.
• Memorizzazione eventi: Salva gli eventi in un file .ics locale o li sincronizza con calendari CalDAV (es. Nextcloud).
• Entità calendario: Espone gli eventi come una normale entità calendario all'interno di Home Assistant.
• Risposta agli inviti: Permette di accettare automaticamente gli inviti, solo se includono una località, o quando l'orario è libero, declinando quelli in conflitto. In alternativa, è possibile lasciare la gestione delle risposte alle proprie automazioni.
• Notifica all'organizzatore: Può inviare una notifica all'organizzatore se un invito non contiene informazioni sulla località.
• Creazione eventi via automazione: Consente alle automazioni di creare, spostare o cancellare eventi tramite email di invito formattate, incluse serie ricorrenti.
• Dettagli eventi avanzati: La funzione list_events restituisce informazioni aggiuntive non sempre disponibili con il metodo standard calendar.get_events, come UID, organizzatore, partecipanti e stato di accettazione.
• Notifiche per automazioni: Invia un segnale (bus event) dopo ogni modifica, permettendo alle automazioni di reagire in tempo reale senza dover effettuare polling continuo.

Installazione e configurazione

L'installazione di Invite Calendar avviene tramite HACS (Home Assistant Community Store). Dopo aver aggiunto il repository custom ([https://github.com/BarBaar44/invite-calendar](https://github.com/BarBaar44/invite-calendar)) in HACS, è possibile installare il componente e riavviare Home Assistant. La configurazione iniziale è guidata dall'interfaccia utente e richiede l'impostazione della casella email IMAP e la scelta tra la memorizzazione locale in un file .ics o la connessione a un server CalDAV, per cui verranno richiesti indirizzo del server, credenziali e la selezione del calendario desiderato. L'integrazione di Invite Calendar Home Assistant è fondamentale per il corretto funzionamento.

Compatibilità e test

Invite Calendar è stato sviluppato con particolare attenzione alla robustezza, utilizzando un set di oltre 200 test automatici, inclusi test contro un server CalDAV reale. È stato testato con successo con Home Assistant 2026.9 e versioni successive, server IMAP/SMTP come mailcow, e server CalDAV come Nextcloud e Radicale. Funziona anche con Gmail e Nextcloud come organizzatori di eventi. Il componente supporta server IMAP che consentono l'uso di keyword personalizzate. Non è supportato l'uso di Exchange/EWS o login tramite Gmail API o OAuth (è possibile utilizzare una password per app tramite IMAP). Gli sviluppatori accolgono feedback per migliorare la compatibilità con altri server di posta e client di calendario come Outlook e iCloud.