-
v0.4.1
StableAll checks were successfulreleased this
2026-09-06 21:14:36 +00:00 | 0 commits to main since this releaseFixed
- Capped
mcp[cli]to<2(was unbounded>=1.28.1). Themcp2.x release renamedFastMCPtoMCPServerand moved the module, whichapp/server.py'sexcept ImportErrorfallback silently treated as "SDK not installed" and swapped in a no-op stub server (tools/resources/prompts became inert,mcp.run()a no-op). Since neither the Dockerfile nor CI pin dependency versions, fresh builds were silently resolvingmcp==2.1.1and shipping a non-functional server. - Added
PLR0917to the ruff ignore list (new rule in ruff 0.16.x, same rationale as the existingPLR0913ignore for the multi-parameter HA API tool functions)
Dependencies
- Pinned
mcp[cli]to>=1.28.1,<2 - Upgraded dev tooling floors:
ruff0.15.22 -> 0.16.6,mypy2.3.0 -> 2.3.1 (and matching.pre-commit-config.yamlrevs, which had drifted from the floors) - Regenerated
requirements-lock.txtagainst the cappedmcpconstraint - Removed unused
uv.lock(stale since the initial commit; the project usespip/Taskfile.yml, neveruv)
Container Image
Docker image available on Forgejo:
https://git.timstoop.nl/tim/-/packages/container/hass-mcp/docker pull git.timstoop.nl/tim/hass-mcp:0.4.1Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Capped
-
v0.4.0 Stable
released this
2026-07-22 08:35:36 +00:00 | 8 commits to main since this releaseAdded
search_logbook: search logbook entries by pattern (string or regex) with scoped time range, entity/domain filters, lean output, and response size capget_energy_dashboard: read the Home Assistant energy dashboard configuration (sources, device consumption)save_energy_dashboard: write the Home Assistant energy dashboard configurationlist_config_entries: list Home Assistant integrations (config entries) with optional search filterreload_integration: reload an integration by its config entry IDreload_entity_integration: look up which integration manages a given entity, then reload itget_server_info: return MCP server build timestampget_entity_from_registry: get entity registry details for an entity (name, icon, area, disabled/hidden state, platform, unique_id)update_registry_entity: update entity registry fields: rename friendly name, rename entity_id, assign area, set icon, disable or hide entitydocker-buildtask in Taskfile for local image builds
Changed
- Renamed tools to drop
_toolsuffix:search_entities_tool->search_entities,domain_summary_tool->domain_summary,call_service_tool->call_service,delete_config_tool->delete_config,get_logbook_tool->get_logbook,search_error_log_tool->search_error_log,list_bluetooth_devices_tool->list_bluetooth_devices - Compacted tool docstrings to reduce context window usage
- Release process: merging to
mainnow auto-tags via CI based on thepyproject.tomlversion (.forgejo/workflows/auto-tag.yml); manual tagging is no longer required
Dependencies
- Re-added
httpx(required for config entry reload, which has no WebSocket equivalent) - Upgraded
mcp[cli]1.25.0 -> 1.28.1,websockets14.0 -> 16.1.1,httpx-> 0.28.1 - Upgraded dev/test tooling:
pytest-> 9.1.1,pytest-asyncio-> 1.4.0,coverage-> 7.15.2,bandit-> 1.9.4,ruff-> 0.15.22 - Upgraded
mypy1.20.2 -> 2.3.0 (major version bump; no code changes required, all checks still pass)
Container Image
Docker image available on Codeberg:
https://git.timstoop.nl/tim/-/packages/container/hass-mcp/docker pull git.timstoop.nl/tim/hass-mcp:0.4.0Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
v0.3.0 Stable
released this
2026-04-28 21:44:50 +00:00 | 30 commits to main since this releaseAdded
list_bluetooth_devicestool: discover and monitor Bluetooth devices via WebSocket subscription
Changed
- Replaced REST/httpx transport with WebSocket (
websocketslibrary) for all Home Assistant API calls - Python version bumped to 3.13.9
Fixed
- Bluetooth advertisement subscription now handles HA 2026.x batch event format (
{"add": [...]}) alongside the legacy per-device format - Message loop reworked so WebSocket events arriving before or after the result confirmation both work correctly
Dependencies
- Removed
httpx - Bumped
ruff,mypy,pytest,pytest-covto current releases
Container Image
Docker image available on Codeberg:
https://git.timstoop.nl/tim/-/packages/container/hass-mcp/docker pull git.timstoop.nl/tim/hass-mcp:0.3.0Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
-
v0.2.1 Stable
released this
2026-03-07 15:10:41 +00:00 | 43 commits to main since this releaseFixed
call_service_toolPydantic validation error when Home Assistant returns a list of affected entities instead of a dict- MCP prompts failing with "Could not convert prompt result to message" due to invalid
systemrole (MCP only supportsuserandassistantroles)
Changed
- Automated release pipeline: pushing a
vX.Y.Ztag now automatically creates a Forgejo release with the relevant CHANGELOG section
Container Image
Docker image available on Codeberg:
https://git.timstoop.nl/tim/-/packages/container/hass-mcp/docker pull git.timstoop.nl/tim/hass-mcp:0.2.1Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads