About
Microsoft 365 - Mail is an integration that reads and sends Microsoft 365 email from Home Assistant. It adds sensors for mail in a chosen folder and a notifier for sending messages, and it relies on Microsoft's cloud. The sensors can be filtered by sender, attachments, importance, unread state, and text in the subject or body. Options also cover showing attachment names, saving attachments, and outputting the body as HTML. Actions can schedule or disable an automatic reply, and a shared mailbox can be used. Setup is done in the UI with a client ID and client secret.
Automatic summary of the README and code of RogerSelwyn/MS365-Mail. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Connect
- Uniquely identifying name for the entities
- Client ID
- Client Secret
- Use alternate (more complex) authentication
- Enable update services
- Email address/ID of shared mailboxDo not put your own email address in this box
- Enable management of autoreply
- API CountryOnly use if you know you need it since your credentials will be sent to the selected api/country.
Request default
- Returned URL
After setup
- Mail folder to monitor
- Max number of items
- Unread items
- Only retrieve emails from this email address
- Has attachments
- Importance Level
- Subject contains
- Subject is
- Body contains
- Show attachment names
- Save attachments
- Output HTML body
- Show body on entity
Texts from the code of RogerSelwyn/MS365-Mail.
Actions
- Auto reply enableSchedules auto replyFields: External reply, Internal Reply, Start date & time, End date & time, External Audience
- Auto reply disableDisables auto reply
- Mail SendSends a mailFields: Subject, Message, To, From, Importance, Message is HTML, Photos, Attachments, ZIP attachments, ZIP file name
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
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. Please don't feel you are obligated to donate, but of course it is appreciated.
Shows in Vulpo
Chart card, Apple Watch.Information
- Installs
- 178 sharing analytics
- GitHub stars
- 20
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- v1.13.2,
- Category
- Productivity and information, Calendars and to-dos
- Kind
- Marketplace integration
- Brand
- Microsoft
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
ms365_mail- Issues
- Report an issue




















