Skip to content

RogerSelwyn/O365-HomeAssistant

Repository files navigation

Validate with hassfest HACS Validate CodeFactor Downloads for latest release GitHub Downloads (all assets, all releases)

GitHub release maintained maintainer hacs_badge Community Forum

Deprecation Notice:

The Calendar, Mail Notification and To Do entities and services are now deprecated in the O365 integration. Teams will also be deprecated in the near future at which point all development on O365 will stop unless it is required to support migration to the MS365 integrations.

Details on how to migration to the new MS365 integrations can be found here - Migration

Note:

This integration is slowly moving towards EOL. I have already created integrations which will replace it - MS365-Calendar/Mail/Teams/ToDo, these can be used now using HACS Custom. When these are available on HACS Default I will then stop work on O365-HomeAssistant.

Many will have seen a warning in the logs - Detected that custom integration 'o365' uses 'async_config_entry_first_refresh', which is only supported for coordinators with a config entry and will stop working in Home Assistant 2025.11 - this further forces the EOL due to a change in HA Core, which means that the integration will cease to work after the 2025.11 HA release without really significant re-work. Because this integration is setup via YAML, it does not have a config_entry, the replacements listed above do.

O365 --> MS365 - A potential big change - your views needed

Office 365 Integration for Home Assistant

This is a fork of the original integration by @PTST which has now been archived.

This integration enables:

  1. Getting and creating calendar events
  2. Getting emails from your inbox using one of two available sensor types (e-mail and query)
  3. Sending emails via the notify.o365_email service
  4. Getting presence from Teams (not for personal accounts)
  5. Getting the latest chat message from Teams (not for personal accounts)
  6. Getting and creating To-Do tasks
  7. Setting Auto Reply/Out of Office response

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

I work on this integration because I like things to work well for myself and others. Whilst I have now made significant changes to the integration, it would not be as it stands today without the major work to create it put in by @PTST. Please don't feel you are obligated to donate, but of course it is appreciated.

Buy Me A Coffee Donate with PayPal

Documentation

The full documentation is available here - O365 Documentation

Nice video from fixtse showing how to install the O365 integration to Home Assistant. Also providing some Lovelace cards for displaying content from O365 - O365 Card for Home Assistant

Migration

Details on how to migration to the new MS365 integrations can be found here - Migration