Releases: homeassistant-ai/ha-mcp
Release list
Dev Build 8.3.0.dev2402
Development Build
Version: 8.3.0.dev2402
Commit: 6918cbd
Branch: master
This is an automated development build. Use at your own risk.
For stable releases, download from the latest release.
Installation
Docker (dev channel):
docker pull ghcr.io/homeassistant-ai/ha-mcp:devPyPI (dev channel):
pip install ha-mcp-devDev Build 8.3.0.dev2401
Development Build
Version: 8.3.0.dev2401
Commit: 858d09e
Branch: master
This is an automated development build. Use at your own risk.
For stable releases, download from the latest release.
Installation
Docker (dev channel):
docker pull ghcr.io/homeassistant-ai/ha-mcp:devPyPI (dev channel):
pip install ha-mcp-devDev Build 8.3.0.dev2400
Development Build
Version: 8.3.0.dev2400
Commit: fc75b66
Branch: master
This is an automated development build. Use at your own risk.
For stable releases, download from the latest release.
Installation
Docker (dev channel):
docker pull ghcr.io/homeassistant-ai/ha-mcp:devPyPI (dev channel):
pip install ha-mcp-devDev Build 8.3.0.dev2397
Development Build
Version: 8.3.0.dev2397
Commit: 0bb3fa0
Branch: master
This is an automated development build. Use at your own risk.
For stable releases, download from the latest release.
Installation
Docker (dev channel):
docker pull ghcr.io/homeassistant-ai/ha-mcp:devPyPI (dev channel):
pip install ha-mcp-devDev Build 8.3.0.dev2395
Development Build
Version: 8.3.0.dev2395
Commit: 574d9c3
Branch: master
This is an automated development build. Use at your own risk.
For stable releases, download from the latest release.
Installation
Docker (dev channel):
docker pull ghcr.io/homeassistant-ai/ha-mcp:devPyPI (dev channel):
pip install ha-mcp-devv8.3.0
Added
- Cover stdio visibility and preserve issue reports
(#2233) - Rename the add-on tools to ha_get_app / ha_manage_app and finish the App wording
(#2222) - Reconfigure existing Home Assistant integrations safely
(#2149) - Show installation method in settings footer
(#2231) - Add process action to ha_manage_pipeline
(#2215) - webhook-proxy: Mirror the unified OAuth surface onto the dev flavor and gate it on backend liveness
(#2218) - OAuth follow-up — component 2.0.0, approved review fold-ins, multi-origin registrations for Google Spark
(#2217) - Claude-proof OAuth surface — unified endpoints, in-component CIMD validation, DCR compat
(#2213) - site: Add Hermes Agent support to setup wizard
(#2208) - Add the Czech (cs) locale across all four translated surfaces
(#2207) - logs: Add structured summary mode to ha_get_logs(source='error_log')
(#2107) - Add the Esperanto (eo) locale across all four translated surfaces
(#2179)
Changed
- Finish the app wording on the README settings-UI line
(b51bf22) - Clarify HACS pre-release selection
(#2227)
Fixed
- Reuse shared locale translations and update Gemini model
(#2232) - Explain how to disable startup notification
(#2230) - Leg-consistent refresh comparison, DCR nesting hardening, raw Basic credentials
(#2219) - Add restart action to legacy OAuth repair
(#2211) - Support history_stats and mold_indicator helpers in ha_config_set_helper
(#2206) - Handle null trigger states in automation traces
(#2203) - Repair locale divergences from the English source and guard the class in CI
(#2180) - Support opaque access tokens in OIDC mode
(#2194) - Survive a rich older than fastmcp's logging setup expects
(#2195)
Internal Changes
Chores
- addon: Publish dev addon version 8.2.0.dev2367 [skip ci]
(47059a4) - addon: Promote webhook-proxy dev -> stable 3.0.1
(#2234) - addon: Publish dev addon version 8.2.0.dev2364 [skip ci]
(f5fca75) - addon: Publish dev addon version 8.2.0.dev2362 [skip ci]
(4a97702) - Machine-translate locale updates
(083ebc1) - addon: Publish dev addon version 8.2.0.dev2360 [skip ci]
(25b33d4) - addon: Publish dev addon version 8.2.0.dev2358 [skip ci]
(e552e7f) - Machine-translate locale updates
(8963ff6) - addon: Publish dev addon version 8.2.0.dev2354 [skip ci]
(acc4372) - Sync tool docs after merge [skip ci]
(7421a6b) - addon: Publish dev addon version 8.2.0.dev2352 [skip ci]
(9f56f6d) - addon: Promote webhook-proxy dev -> stable 3.0.0
(#2221) - addon: Publish dev addon version 8.2.0.dev2342 [skip ci]
(401da43) - Sync tool docs after merge [skip ci]
(74144c7) - Machine-translate locale updates
(f594e79) - addon: Publish dev addon version 8.2.0.dev2335 [skip ci]
(0bba842) - Machine-translate locale updates
(b6d8201) - addon: Publish dev addon version 8.2.0.dev2331 [skip ci]
(ceb6860) - addon: Publish dev addon version 8.2.0.dev2328 [skip ci]
(2d9e959) - Sync tool docs after merge [skip ci]
(163e736) - addon: Publish dev addon version 8.2.0.dev2326 [skip ci]
(7549ea2) - Machine-translate locale updates
(c8a1b31) - addon: Publish dev addon version 8.2.0.dev2323 [skip ci]
(bbf42a2) - Sync tool docs after merge [skip ci]
(4c310c4) - addon: Publish dev addon version 8.2.0.dev2321 [skip ci]
(59f048b) - addon: Publish dev addon version 8.2.0.dev2318 [skip ci]
(f6e7680) - addon: Publish dev addon version 8.2.0.dev2313 [skip ci]
(797f5f3) - addon: Publish dev addon version 8.2.0.dev2311 [skip ci]
(26cc349) - Machine-translate locale updates
(f59e548) - addon: Publish dev addon version 8.2.0.dev2309 [skip ci]
(e92d9a9) - addon: Publish dev addon version 8.2.0.dev2307 [skip ci]
(06ecc31) - addon: Publish dev addon version 8.2.0.dev2305 [skip ci]
(5703328) - addon: Publish version 8.2.0 [skip ci]
(767dc9d)
Continuous Integration
- deps: Bump renovatebot/github-action in the github-actions group
(#2226) - Harden Renovate follow-up behavior
(#2202) - Restore Renovate updates and vulnerability-alert access
(#2200) - Harden dependency supply chain
(#2196) - deps: Bump renovatebot/github-action in the github-actions group
(#2193)
Testing
- Generalize PR checkout credential guard
(#2199)
v8.2.0
Added
- Add the Swedish (sv) locale across all four translated surfaces
(#2173) - Add the Polish (pl) locale across all four translated surfaces
(#2171) - Automatically surface component updates in HACS after a server update
(#2166) - Add update_information action to ha_manage_hacs
(#2165) - Add redact_secrets toggle to redact secrets from tool responses
(#2164) - Add ha_manage_security_policy tool behind Policies-tab toggle
(#2155) - Add the Dutch (nl) locale across all four translated surfaces
(#2145) - Add security policy access toggle for dev tools
(#2147)
Fixed
- Route the embedded self-reload through the shielded services endpoint
(#2184) - Allow updates to existing hyphenless dashboards
(#2181) - Schedule the HACS refresh nudge via the FastMCP lifespan
(#2172) - Keep hardcoded config-entry titles untranslated too
(#2175) - Keep hardcoded config-flow labels untranslated
(#2170) - Reject dangling registry references across all registry write tools
(#2162) - Reject blank locale catalog values instead of rendering them
(#2163) - Validate entity area IDs
(#2160) - Close truncated release-note fences correctly and surface empty extracts
(#2156) - Cap release notes at GitHub's 125k body limit
(#2154)
Internal Changes
Chores
- addon: Publish dev addon version 8.1.1.dev2296 [skip ci]
(1fbe682) - addon: Publish dev addon version 8.1.1.dev2294 [skip ci]
(74712d7) - addon: Publish dev addon version 8.1.1.dev2292 [skip ci]
(6b357ff) - addon: Publish dev addon version 8.1.1.dev2289 [skip ci]
(8689bf8) - Machine-translate locale updates
(5db8bf8) - addon: Publish dev addon version 8.1.1.dev2287 [skip ci]
(319f360) - addon: Publish dev addon version 8.1.1.dev2284 [skip ci]
(3a27265) - addon: Publish dev addon version 8.1.1.dev2282 [skip ci]
(c7bf01b) - Machine-translate locale updates
(18fc429) - addon: Publish dev addon version 8.1.1.dev2280 [skip ci]
(b474206) - addon: Publish dev addon version 8.1.1.dev2278 [skip ci]
(22ede66) - Machine-translate locale updates
(b481929) - addon: Publish dev addon version 8.1.1.dev2274 [skip ci]
(cbdf028) - Sync tool docs after merge [skip ci]
(6a5a993) - addon: Publish dev addon version 8.1.1.dev2271 [skip ci]
(2eb8f70) - addon: Publish dev addon version 8.1.1.dev2269 [skip ci]
(759c150) - Enable CodeRabbit auto-review on non-default base branches
(#2168) - addon: Publish dev addon version 8.1.1.dev2266 [skip ci]
(0acd87c) - addon: Publish dev addon version 8.1.1.dev2263 [skip ci]
(767c248) - Sync tool docs after merge [skip ci]
(7f5d59c) - addon: Publish dev addon version 8.1.1.dev2261 [skip ci]
(cf0b883) - addon: Publish dev addon version 8.1.1.dev2259 [skip ci]
(20199b6) - Machine-translate locale updates
(306fada) - addon: Publish dev addon version 8.1.1.dev2256 [skip ci]
(ec525a7) - Sync tool docs after merge [skip ci]
(4bef86a) - deps: Bump js-yaml from 4.2.0 to 4.3.1 in /site
(#2161) - addon: Publish version 8.1.1 [skip ci]
(a66c87b)
v8.1.1
v8.1.0
Added
- Land machine translations post-merge instead of in the PR
(#2115) - site: Add shareable setup wizard URLs
(#2117)
Changed
- Document Webhook Proxy ha_auth as an access gate, not per-user authorization
(#2140) - Document settings-UI and OIDC trust properties in SECURITY.md
(#2136)
Fixed
- Observe the shutdown cleanup task result
(#2139) - Cancel pending worker-loop tasks before embedded teardown
(#2128) - Drive flows that revisit menu steps via successive selection lists
(#2124) - Replace the stdio settings sidecar on every startup and keep its URL stable
(#2134) - Clarify the addon-not-back error message
(#2132) - Anchor the translation prompt to each catalog's address register
(#2110)
Internal Changes
Chores
- addon: Publish dev addon version 8.0.0.dev2238 [skip ci]
(04c6e4f) - Machine-translate locale updates
(ee165e8) - addon: Publish dev addon version 8.0.0.dev2235 [skip ci]
(1373d02) - addon: Publish dev addon version 8.0.0.dev2233 [skip ci]
(c8dfbb3) - addon: Publish dev addon version 8.0.0.dev2230 [skip ci]
(2d3fc9d) - Sync tool docs after merge [skip ci]
(8cc8398) - addon: Publish dev addon version 8.0.0.dev2228 [skip ci]
(b791edb) - addon: Publish dev addon version 8.0.0.dev2224 [skip ci]
(d4167d2) - deps: Update dependency home-assistant/operating-system to v18.2
(#2138) - deps: Update src/ha_mcp/resources/skills-vendor digest to 9e4eff2
(#2137) - addon: Publish dev addon version 8.0.0.dev2222 [skip ci]
(55688dc) - addon: Publish dev addon version 8.0.0.dev2220 [skip ci]
(c9aaf4c) - Machine-translate locale updates
(d1f74e5) - addon: Publish dev addon version 8.0.0.dev2218 [skip ci]
(ad65918) - Replace the retired triage bot with CodeRabbit issue enrichment
(#2125) - Let CodeRabbit review draft PRs
(#2118) - deps-dev: Bump fast-uri from 3.1.4 to 3.1.5 in /site
(#2130) - deps: Bump postcss from 8.5.21 to 8.5.25 in /site
(#2129) - addon: Publish dev addon version 8.0.0.dev2212 [skip ci]
(2222a10) - addon: Publish dev addon version 8.0.0.dev2207 [skip ci]
(ac057ed) - addon: Publish dev addon version 8.0.0.dev2203 [skip ci]
(cde9b5c) - addon: Publish version 8.0.0 [skip ci]
(c6eacb0)
Continuous Integration
- deps: Bump the github-actions group with 5 updates
(#2123)
v8.0.0
Added
- Warn when a variables key reads a later key in the same block
(#2084) - Single-source translations with generated catalogs and automatic retranslation
(#2095) - Add the Italian (it) locale across all four translated surfaces
(#2062) - Embed inline dashboard resources as data: URIs instead of the Cloudflare worker
(#2069) - Add the Spanish (es) locale across all four translated surfaces
(#2055) - Complete the Simplified Chinese (zh-Hans) locale and enforce locale parity
(#2042) - Remove ha-mcp-sse entry point
(#2032) - Include RFC 9207 iss parameter in OAuth authorization responses
(#2033) - Rework tool security policy semantics (ANY-match) + developer tools to drive the settings UI
(#1993) - Add opt-in enforce mode to the entity visibility filter
(#2024) - Let operators extend the YAML write allowlist behind a deny floor
(#1997) - Allow state_filter-only ha_search to enumerate entities by state
(#2018)
Changed
- Warn Tailscale Funnel users that Claude.ai connectors need port 443 (#2080)
(#2094) - Self-host the README star history chart
(#2086) - Make the add-a-language procedure match what CI enforces
(#2074) - Pin mcp<2.0.0 in the mcp-proxy configs we generate
(#2075) - Correct pinned-tool docs — mandatory tools cannot be unpinned
(#2061) - Document ChatGPT stale connector tool list workaround
(#2017) - Add auth/ package to the architecture tree
(#2012)
Fixed
- Read only the project .env, and close the CI lint-scope gaps from the #2102 review
(#2105) - Report per-item failures in bulk operation status instead of aborting the batch
(#2076) - Resubmit config keys redeclared by later flow steps
(#2087) - Return service_response once at top level in ha_call_service
(#2088) - Swap the stdio bridge from mcp-proxy to fastmcp-remote
(#2101) - Authenticate star history generation
(#2098) - Make Docker settings persist across container re-creation
(#2079) - Reword tool search warnings to target clients, not Claude models
(#2077) - Pin the English tool texts that translations are written against
(#2064) - Make one English string read the same on every translated surface
(#2063) - Offload secrets.yaml masking to the executor
(#2068) - Reject cross-panel links that point at a tab which does not exist
(#2046) - Propagate cancellation in deep-search fan-outs and usage logging
(#2045) - Resolve a bracketed YAML path as both pattern and literal
(#2036) - Standard-mode console logging + relay-stub upstream contract pins
(#2039) - Promote-flow dev version rebase and e2e entry-setup gate
(#2040) - Retry Supervisor add-on calls on job-group collisions
(#2041) - Create all-day calendar events from date-only values
(#2035) - Drop wall-clock total from MCP relay stream timeouts
(#2034) - Dashboard search stays on legacy path without false partial
(#2020) - Bound each addon HA-link probe by the readiness deadline
(#2028) - Force-exit the stdio entry point to avoid SIGABRT at shutdown
(#2029) - Report Hue/YAML scenes as CONFIG_NOT_FOUND, not ENTITY_NOT_FOUND
(#2003) - Clarify missing "File & YAML Tools" entry in error text and options UI
(#2019) - Honor view_path scoping in ha_config_get_dashboard get mode
(#2023) - Restore read-only annotations on the dashboard get and screenshot tools
(#2014) - Prevent overlapping overview pages
(#2009) - Keep the WebSocket pool usable after an event-loop change
(#2001)
Internal Changes
Fixed
- Hold pydantic-monty at 0.0.18 and satisfy ruff 0.16 LOG004
(#2054)
Chores
- addon: Publish dev addon version 7.14.2.dev2198 [skip ci]
(fb56691) - addon: Publish dev addon version 7.14.2.dev2196 [skip ci]
(821c29d) - addon: Publish dev addon version 7.14.2.dev2193 [skip ci]
(5731e27) - addon: Publish dev addon version 7.14.2.dev2190 [skip ci]
(05d4131) - Sync tool docs after merge [skip ci]
(7afe5eb) - addon: Publish dev addon version 7.14.2.dev2188 [skip ci]
(83168a4) - addon: Publish dev addon version 7.14.2.dev2185 [skip ci]
(46d600f) - Sync tool docs after merge [skip ci]
(56f95c5) - addon: Publish dev addon version 7.14.2.dev2183 [skip ci]
(8ffdffd) - addon: Publish dev addon version 7.14.2.dev2181 [skip ci]
(6f43de9) - Enable targeted ruff pylint rules, fix 104 violations
(#2102) - addon: Publish dev addon version 7.14.2.dev2175 [skip ci]
(d51860b) - addon: Publish dev addon version 7.14.2.dev2173 [skip ci]
(562602e) - addon: Publish dev addon version 7.14.2.dev2171 [skip ci]
(e857c32) - addon: Publish dev addon version 7.14.2.dev2169 [skip ci]
(1786ad9) - addon: Publish dev addon version 7.14.2.dev2167 [skip ci]
(70cb939) - addon: Publish dev addon version 7.14.2.dev2165 [skip ci]
(0717e84) - addon: Publish dev addon version 7.14.2.dev2162 [skip ci]
(1d69b3e) - Sync tool docs after merge [skip ci]
(c30ffb1) - addon: Publish dev addon version 7.14.2.dev2160 [skip ci]
(c1404c7) - addon: Publish dev addon version 7.14.2.dev2158 [skip ci]
(26269a6) - addon: Publish dev addon version 7.14.2.dev2156 [skip ci]
(559448f) - addon: Publish dev addon version 7...