Home Assistant MCP Reporter
A minimal MCP server that exposes a single tool to forward JSON reports from Home Assistant to Power Automate webhooks. It enables automated workflow integration by securely transmitting data between Home Assistant and Microsoft Power Automate.
Ask AI about Home Assistant MCP Reporter
Powered by Claude · Grounded in docs
I know everything about Home Assistant MCP Reporter. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Home Assistant MCP Reporter
This repository contains a minimal Python MCP server packaged as a Home Assistant add-on.
What it does
The server exposes one MCP tool:
postReport
postReport accepts a JSON object and forwards it to the configured Power Automate webhook.
Authentication
The add-on requires an API key configured from the Home Assistant add-on config page.
Send the API key in either of these headers when calling the MCP endpoint:
X-API-Key: <your-key>Authorization: Bearer <your-key>
Local development
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .
python -m mcp_reporter_server
The server listens on 0.0.0.0:8099 using streamable HTTP transport at /.
For discovery, the server also exposes authenticated tool-list endpoints at:
GET /toolsPOST /tools
Home Assistant installation
- Add this repository as an add-on repository in Home Assistant.
- Install the
MCP Reporteradd-on. - Start the add-on.
- Connect your MCP client to
http://homeassistant.local:8099/or the add-on host/IP on port8099.
Notes
- The webhook URL is baked in by default to match the requested behavior.
- You can override it with the
POWER_AUTOMATE_WEBHOOK_URLenvironment variable if needed.