therudin/teamsassist-macos

TeamsAssist for macOS is a small background utility that watches your Microsoft Teams status on a Mac and sends it to Home Assistant, a popular open source smart home platform. The idea is to let your lights, dashboards, or other smart home automations react automatically to whether you are in a meeting, busy, or available. The tool runs entirely on your own computer and does not need special admin approval from Microsoft to work. It supports both the older Classic Teams app and the newer Teams client. For the new Teams client, it watches macOS system signals that Teams triggers to stop the computer from going to sleep during a call. For Classic Teams, it reads a local log file to detect your presence status, such as Available, Busy, or Away. Once it detects a status, the utility sends that information to Home Assistant over a simple web request, updating sensors that Home Assistant automations can then use to trigger anything from smart lights to notifications. Setup involves adding a few sensor definitions to your Home Assistant configuration file, generating a long lived access token using an included script, and editing a settings file with your Home Assistant address, token, and preferences. The daemon installs as a macOS Launch Agent, meaning it starts automatically each time you log in and runs quietly in the background using pure Python with no extra dependencies. It also includes manual commands for testing, so you can simulate call or presence changes without actually joining a Teams meeting, along with log files for troubleshooting and a simple uninstall command. This is a small hobbyist project with 3 stars, aimed at people who already use Home Assistant and want their smart home to respond to their Teams meeting status.