mysa2mqtt

Expose Mysa smart thermostats to Home Assistant and other home automation platforms via MQTT.

npx mysa2mqtt --help
# or
docker run --rm bourquep/mysa2mqtt --help

📖 Full mysa2mqtt documentation → — installation, configuration, Home Assistant integration, Docker usage and troubleshooting.

Packages

This repository is a monorepo. Each package is published to npm independently, under its own version line, and can be used on its own.

Package	Version	Description
mysa2mqtt		The command-line tool and Docker image.
mysa-js-sdk		JavaScript SDK for accessing Mysa smart thermostats.
mqtt2ha		Create MQTT entities that Home Assistant discovers automatically.

API documentation for the two libraries is published at bourquep.github.io/mysa2mqtt.

mysa-js-sdk and mqtt2ha previously lived in their own repositories. They were merged here in July 2026 so that a fix spanning several layers is a single pull request and a single release. Their old repositories are archived and remain readable.

Reporting issues

All three packages share this issue tracker. When you open an issue, pick the affected package from the dropdown — if you're not sure which layer is at fault, choose "Not sure" and it'll get triaged.

Development

npm ci
npm run build      # builds mqtt2ha, then mysa-js-sdk, then mysa2mqtt
npm run lint
npm run typecheck
npm test           # runs each package's test suite (currently mqtt2ha, via vitest)

mqtt2ha is covered by a vitest suite in packages/mqtt2ha/test/; run it in watch mode with npm run test:watch -w mqtt2ha. CI runs lint, typecheck, build, and the tests on every pull request.

Releases are managed with changesets. Add one with npm run changeset in any PR that should ship a new version; see .changeset/README.md for the conventions used here.

Git tags are named <package>@<version> (for example mysa-js-sdk@2.1.0). Tags of the form v1.2.3 are pre-monorepo mysa2mqtt releases and are kept for their GitHub Release pages.

See CONTRIBUTING.md for more.

License

MIT — see LICENSE.txt.

Copyright © 2025-2026 Pascal Bourque.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

remiolivier 💻	James Myers 💻	jagmandan 💻	vavallee 💻	Olivier Carbonneau 💻	Daniel Caspi 💻	souvik101990 💻
mhlas7 💻

This project follows the all-contributors specification. Contributions of any kind welcome!