Home Assistant Health Plugin (Sample)

This sample plugin fetches daily health metrics from Home Assistant and reports them via Faxbot. It’s a scaffold you can run today while the full plugin loader lands.

What it does

Fetches sensors: sensor.weight, sensor.heart_rate, sensor.blood_pressure
Builds a brief text report
Sends the report to a fax number via your running Faxbot API

Requirements

Node 18+
Faxbot API running locally (http://localhost:8080) with an API key
Home Assistant URL and a long‑lived access token

Setup 1) Configure env

export HOME_ASSISTANT_URL=https://ha.local:8123
export HOME_ASSISTANT_TOKEN=<your_ha_token>
export FAXBOT_URL=http://localhost:8080
export FAXBOT_API_KEY=<your_faxbot_key>
export FAX_TO=+15551234567

2) Run the sample

node scripts/run-plugin-homeassistant.js

Notes

The runner uses Faxbot’s /fax endpoint with a generated text file; Faxbot converts text to PDF automatically.
The sample plugin lives at plugins/samples/homeassistant/ and exports initPlugin(faxbotAPI); the runner provides a minimal Faxbot adapter with sendFax and sendHealthReport.
This is a sample/integration plugin (category: integration); it is not an outbound provider.

Links

Home Assistant docs: https://www.home-assistant.io/docs/authentication/