Overview

These are the integrations that make up the full MS365 suite. It is made up of:

All the integrations are built to the same standard with the same authentication and configuration mechanism. All the integrations can use the same Entra ID App Registration and secret if desired.

This project would not be possible without the wonderful python-o365 project.

Microsoft 365 Home Assistant Documentation

This repository provides the foundational guides for all the integrations. Integration specific detail is provided in the documentation for the specific integration and is linked to from this guide. In general:-

  1. Prerequisites - Guidance on how to setup Entra ID App Registration
  2. Permissions - Optionally pre-add permissions as required by the integration. Required permissions will be requested at authentication time if not already granted.
  3. Installation - Install the integration into Home Assistant.
  4. Authentication - Authenticate to your Microsoft 365 account, and authorise access permissions (if required).

Additionally

  • Errors - Errors you may see, and what to do
  • Events - The various integrations raise HA Events, which can be used to trigger automation
  • Services - Integration specific services, typically for update actions
  • Token - Information regarding tokens

Within each repository there is also information relevant to the indidual integration.