https://github.com/rogerselwyn/o365-homeassistant

Office 365 integration for Home Assistant
https://github.com/rogerselwyn/o365-homeassistant

home-assistant homeassistant homeassistant-custom-component homeassistant-integration microsoft o365

Last synced: 8 months ago
JSON representation

Office 365 integration for Home Assistant

• Host: GitHub
• URL: https://github.com/rogerselwyn/o365-homeassistant
• Owner: RogerSelwyn
• License: mit
• Created: 2021-03-04T11:10:22.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2025-09-09T08:15:05.000Z (9 months ago)
• Last Synced: 2025-09-09T10:56:45.410Z (9 months ago)
• Topics: home-assistant, homeassistant, homeassistant-custom-component, homeassistant-integration, microsoft, o365
• Language: Python
• Homepage:
• Size: 1.41 MB
• Stars: 223
• Watchers: 3
• Forks: 16
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Validate with hassfest](https://github.com/RogerSelwyn/O365-HomeAssistant/actions/workflows/hassfest.yaml/badge.svg)](https://github.com/RogerSelwyn/O365-HomeAssistant/actions/workflows/hassfest.yaml) [![HACS Validate](https://github.com/RogerSelwyn/O365-HomeAssistant/actions/workflows/hacs.yaml/badge.svg)](https://github.com/RogerSelwyn/O365-HomeAssistant/actions/workflows/hacs.yaml) [![CodeFactor](https://www.codefactor.io/repository/github/rogerselwyn/o365-homeassistant/badge)](https://www.codefactor.io/repository/github/rogerselwyn/o365-homeassistant) [![Downloads for latest release](https://img.shields.io/github/downloads/RogerSelwyn/O365-HomeAssistant/latest/total.svg)](https://github.com/RogerSelwyn/O365-HomeAssistant/releases/latest) ![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/RogerSelwyn/O365-HomeAssistant/total?label=downloads%40all)

[![GitHub release](https://img.shields.io/github/v/release/RogerSelwyn/O365-HomeAssistant)](https://github.com/RogerSelwyn/O365-HomeAssistant/releases/latest) [![maintained](https://img.shields.io/maintenance/yes/2025.svg)](#) [![maintainer](https://img.shields.io/badge/maintainer-%20%40RogerSelwyn-blue.svg)](https://github.com/RogerSelwyn) [![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg)](https://github.com/hacs/integration) [![Community Forum](https://img.shields.io/badge/community-forum-brightgreen.svg)](https://community.home-assistant.io/t/office-365-calendar-access)

# Deprecation Notice:

The Calendar, Mail Notification, Teams and To Do entities and services are now deprecated in the O365 integration. Development on O365 has now stopped unless a change is required to support migration to the MS365 integrations.

Details on how to migrate to the new MS365 integrations can be found here - [Migration](https://rogerselwyn.github.io/O365-HomeAssistant/migration.html)

# Note: 

This integration is very close to EOL. I have already created integrations which will replace it - MS365-Calendar/Mail/Teams/ToDo, these can now be found on HACS. 

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](https://github.com/RogerSelwyn/O365-HomeAssistant/discussions/234)

# 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

1. Getting emails from your inbox using one of two available sensor types (e-mail and query)

1. Sending emails via the notify.o365_email service

1. Getting presence from Teams (not for personal accounts)

1. Getting the latest chat message from Teams (not for personal accounts)

1. Getting and creating To-Do tasks

1. Setting Auto Reply/Out of Office response

This project would not be possible without the wonderful [python-o365 project](https://github.com/O365/python-o365).

## [Buy Me A Beer 🍻](https://buymeacoffee.com/rogtp)

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.

 



  



# Documentation

The full documentation is available here - [O365 Documentation](https://rogerselwyn.github.io/O365-HomeAssistant/)

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](https://github.com/fixtse/o365-card)

# Migration

Details on how to migration to the new MS365 integrations can be found here - [Migration](https://rogerselwyn.github.io/O365-HomeAssistant/migration.html)