{"_id":"@orellbuehler/homeassistant-mcp","_rev":"12-e947beb184e98764bada19ea513ca366","name":"@orellbuehler/homeassistant-mcp","dist-tags":{"latest":"0.8.1"},"versions":{"0.1.0":{"name":"@orellbuehler/homeassistant-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","home-assistant","homeassistant","hass","home-automation","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.1.0","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"b0ae94a9abf11bbda509ac90df6b9a87c350717b","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.1.0.tgz","fileCount":16,"integrity":"sha512-o6Gce97a80arSvdfcOn/fjqBiMjFC0CklhyMIWHMCuubumoDEdGNF9Ac8wJ/yi8Dri5LTEjNtGlj5ChSKljfAg==","signatures":[{"sig":"MEUCIHQeevWC1v0BbJpXbCz3QfBnJPpgY5/PluOXhoNEhkbNAiEAne3d1vVfb2Wcvimh8SG/aNvWNa6i/cAo1Zc9Kclb2+g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33950},"type":"module","engines":{"node":">=18"},"gitHead":"323fe6264f0b2d47be5c40048833adbe8f5f4da1","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"orellbuehler","email":"orell.buehler@gmail.com"},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.7.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.17.0","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.1.0_1780767390316_0.5326999159611452","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@orellbuehler/homeassistant-mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","home-assistant","homeassistant","hass","home-automation","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.2.0","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"1edcab36e2c44e82dda5912c7207bf228c70d5c5","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.2.0.tgz","fileCount":17,"integrity":"sha512-jR/iYJ0houbh5tNQFGyYz0fraZyRXGlYajboif78LrwEgHbxwoLjv3CqjYPulVjz6MzGd1fbh5lnP2s5UdWJEw==","signatures":[{"sig":"MEQCIDoUKoD3ljCIltL36ngWD1iISecSthy0ONj8yzXoXTQBAiBk/IRwO0LIMZis0LBNEtpRrrACJevGSgEbtGW8uVkdUA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":48038},"type":"module","engines":{"node":">=18"},"gitHead":"d17ee5f7df2e0efee30ffd50e043c29d0bfa90d8","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.16.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.2.0_1780840531395_0.1214655310458781","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@orellbuehler/homeassistant-mcp","version":"0.3.0","keywords":["mcp","model-context-protocol","home-assistant","homeassistant","hass","home-automation","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.3.0","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"83aa16fa7124d8bdac505a09d6f568b06cd90593","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.3.0.tgz","fileCount":18,"integrity":"sha512-06iBIuC7TArzUKP5rQ4bMxI6IDzzV25IcWzzbmvHDC4bKrUwYT2VPxETt3+PBUScoZycEmY35i8uQlHOvQNgdA==","signatures":[{"sig":"MEUCIB4AAMgQWeBk9Az5Lr2KqfTEnXyQjoiluUPUmkvmaRtvAiEAtsTgQuMCGmdPPUAJ+Y/jl6vtDbepioIbSgZrS3Cum1g=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":53715},"type":"module","engines":{"node":">=20"},"gitHead":"95af39da0849463646697e0464e772badd58904d","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.16.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.3.0_1780860316318_0.6034200147955895","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@orellbuehler/homeassistant-mcp","version":"0.4.0","keywords":["mcp","model-context-protocol","home-assistant","homeassistant","hass","home-automation","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.4.0","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"701f413457d590d3cc7396f7151a5d2d3e1f6f89","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.4.0.tgz","fileCount":18,"integrity":"sha512-w0YWB9woxKInQqP58683k72aUZG++DT6cZuAWXRqi0gktgytVWbaokQhgPa6L92gzaNlqh6LoSM0RSPOP62u1Q==","signatures":[{"sig":"MEUCIQCviBwzyFpEwSTyoMGrOZhJBfGd/V9HmJASy/Ivzk4FLAIgRi9b55CwGYigLT3hakTycvYDlWJzfvl+DdxUmxpGumc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":55984},"type":"module","engines":{"node":">=20"},"gitHead":"f34bd2ed6772d78369d89998bc97a4fa5a16065e","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.4.0_1781554904608_0.790407423821792","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@orellbuehler/homeassistant-mcp","version":"0.5.0","keywords":["mcp","model-context-protocol","home-assistant","homeassistant","hass","home-automation","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.5.0","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"e48d5add0579843c60d59ea0651c31edccd988ff","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.5.0.tgz","fileCount":19,"integrity":"sha512-vopC6jjTzDHwTdk0Q8eUy/IbMpsFm1xHq5BUVM1RwjW4cEGJSUVoIkmkOUFXgm9yu+/E/Di0phoXm6mWDnMUOg==","signatures":[{"sig":"MEUCIAtXqkTd8FE5n84Z9sigD48i/t5zDcXdDRB0mEyYywWrAiEA+tgpwP4pJtJyPxPJRfrb30y6raIbq/oOL0oOilbRHx0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":64118},"type":"module","engines":{"node":">=20"},"gitHead":"76502f2126ccc576a791eeb353f623ee2b2469e5","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.18.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.23.0","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.5.0_1782760465545_0.3172386651428445","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@orellbuehler/homeassistant-mcp","version":"0.5.1","keywords":["mcp","model-context-protocol","home-assistant","homeassistant","hass","home-automation","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.5.1","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"98f004e2156a9ed95211a77b098e74e98a96c443","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.5.1.tgz","fileCount":19,"integrity":"sha512-o6NgAi1ySymwt+f19rSvtJU9g6nXj6UNjOWFbSbhUE8KDUW6jBUykfajND4IWs3M9iAYPzSDOA6buUs0i7QFaw==","signatures":[{"sig":"MEUCIQCQi1C1LEjoQzHZdZ7gKusINYy9OMOwIFM5zRvEJVR72wIgcCh4dPP7W42S+uNQw7RFKRz1pVsCS4JF+66ulAHmQYo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.5.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":64716},"type":"module","engines":{"node":">=20"},"gitHead":"e966c12fd84e7b8bf1916f24117b5dcac51218c8","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.18.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.23.0","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.5.1_1782761224521_0.4861583233263238","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@orellbuehler/homeassistant-mcp","version":"0.6.0","keywords":["mcp","model-context-protocol","home-assistant","homeassistant","hass","home-automation","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.6.0","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"57c56df64497ab1eafd010773c841866fc3e93a9","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.6.0.tgz","fileCount":21,"integrity":"sha512-fCNwP2udfr5vzX9vN+M8mmmMujXMdJfSclaXMjBl6Jn9GJ5mmT1Za0gdK/mj87QJ0iGpNzX6G77/WFHxuiCXhA==","signatures":[{"sig":"MEUCIQDraTIvGaAo1FR24HsnwAvvirXoLIbUgcn8Xd03u6cvDgIgYYvh7GObHji241MmmgHnfQUCGNXNV30zjT+l2ZtjfjI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":73800},"type":"module","engines":{"node":">=20"},"gitHead":"3d72bb4ab0b14c43a332d3dd76ecf8fda9108087","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.18.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.6.0_1783250668308_0.02622634917744393","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@orellbuehler/homeassistant-mcp","version":"0.7.0","keywords":["mcp","model-context-protocol","home-assistant","homeassistant","hass","home-automation","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.7.0","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"03d691fab23a550c734c8165dc01790ff529b167","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.7.0.tgz","fileCount":22,"integrity":"sha512-1LuZJdYefxVfGpLgyrfdpHCaW/7/084dnFcIE5wY6Kj2iAbPcnVkItzxFIUw9xMWaeyIrZu3WOS4koCpwFOUVQ==","signatures":[{"sig":"MEQCICgbRsBkjegZBwUyz5C8l3IDNX/FHo7s9051xVTb2SRqAiAHyE8nnM7uSODTV0Cil9muE3Q1we++3GJhH3wf/LAx1A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.7.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":79609},"type":"module","engines":{"node":">=20"},"gitHead":"e255802e26b35b6f514177e67256fffef1386981","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.18.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.7.0_1783449542585_0.17079244811073546","host":"s3://npm-registry-packages-npm-production"}},"0.7.1":{"name":"@orellbuehler/homeassistant-mcp","version":"0.7.1","keywords":["mcp","mcp-server","model-context-protocol","home-assistant","homeassistant","hass","home-automation","smart-home","automation","claude","ai-agents","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.7.1","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"691715472554d8c44232f3603a03715d446ad6f8","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.7.1.tgz","fileCount":22,"integrity":"sha512-rQGX2DItxrzSAJzHfVeL+ssciNpaiDvPT46Smx/LgKs0R/8r2UeRDMY2fSI+v8QI9ykTDT1HgEWZhhKEj85jRA==","signatures":[{"sig":"MEYCIQC9jSym6OUc0XTdsxLQRYRGP8NvdJlcsFwI9Nm95YLU0AIhALyzJGWZno4fATWfIkdsgU+PKgWvH21YAAGIs3dRpPkD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.7.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":80992},"type":"module","engines":{"node":">=20"},"gitHead":"6d9a2deedd1899599174ddf7c277d7355a6ac41d","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.18.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.7.1_1783638062941_0.5010298375260493","host":"s3://npm-registry-packages-npm-production"}},"0.7.2":{"name":"@orellbuehler/homeassistant-mcp","version":"0.7.2","keywords":["mcp","mcp-server","model-context-protocol","home-assistant","homeassistant","hass","home-automation","smart-home","automation","claude","ai-agents","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.7.2","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"3ec545fdff099ffdb1a48b851aa1cf3fe3f4733e","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.7.2.tgz","fileCount":22,"integrity":"sha512-FQsOd1kgrerBqXuFX2CANDnjM3ls37qbRi7O3LaM/tw65AAuKduVwLv9d9R2FchtZliYmDnsSzovmYrzzXu0bA==","signatures":[{"sig":"MEQCIFQ/BtveUkt7ZxT08O8XRbqH+Zsofw+IDW2duthE5y/CAiA7puh47y1hEI9V8/4Y+zyhVaS+jNeAQQPwRaRYojbTUA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.7.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":80992},"type":"module","engines":{"node":">=20"},"gitHead":"9f43bcad04ca09dd1ca16178f731edad6944ea77","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.7.2_1786834131887_0.3918101785661814","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"@orellbuehler/homeassistant-mcp","version":"0.8.0","keywords":["mcp","mcp-server","model-context-protocol","home-assistant","homeassistant","hass","home-automation","smart-home","automation","claude","ai-agents","llm","ai"],"author":{"name":"Orell Bühler"},"license":"MIT","_id":"@orellbuehler/homeassistant-mcp@0.8.0","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"bin":{"homeassistant-mcp":"dist/index.js"},"dist":{"shasum":"e6cdf5fcce026e32129bc15ad60420d18e261708","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.8.0.tgz","fileCount":22,"integrity":"sha512-pCIRHXBgrho5av4RNWNz8pmsColY1CERo+laQRZyphIkh81KT759q5efYrz1keAV+c8dvo9vjiA4xIsA4YMCig==","signatures":[{"sig":"MEUCIFL3nTnUPEN6XE1flrwvTbjgH9a0asbSvcje9D+/IOuOAiEA9nvdNDO1yTwair4xYB8pAzlCObSsSp0RTbdKcCz4oXo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.8.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":84296},"type":"module","engines":{"node":">=20"},"gitHead":"6bf0b5c728e12ef023659b6e3676d0d7d93a51e3","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"_nodeVersion":"22.23.2","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/homeassistant-mcp_0.8.0_1787175841426_0.3601232062697748","host":"s3://npm-registry-packages-npm-production"}},"0.8.1":{"_id":"@orellbuehler/homeassistant-mcp@0.8.1","bin":{"homeassistant-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"dist":{"shasum":"2b657318971421600bb0df789e81213ac48be464","tarball":"https://registry.npmjs.org/@orellbuehler/homeassistant-mcp/-/homeassistant-mcp-0.8.1.tgz","fileCount":22,"integrity":"sha512-4eb6hJuDMaG8g8nkxpBWcdNnTwLqVQT2uvloO4rzYSkqI2qCb78HDMc9n0S+IXDEMv4uddwMo5lO8Ke1kXApWA==","signatures":[{"sig":"MEYCIQDMH0/hUE7ACOdvC1vCD23v2mnbFINZ1yBIKMq2TfgZogIhANlolvH+u27U6jgmoAM1ddYNfltHmftQYVLaOz+A1w08","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCwAu30Irmthq/vs3SMeVkOG6TFvQKUHTpz8xhNebHhOAIgQFqQUddeoSl/bnJezOLLfh89PHpUhCjqaWKgBSYLjwU="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@orellbuehler%2fhomeassistant-mcp@0.8.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":84296},"name":"@orellbuehler/homeassistant-mcp","type":"module","author":{"name":"Orell Bühler"},"engines":{"node":">=20"},"gitHead":"d594e873bc5eb65067358707d73dcbe53d01cff4","license":"MIT","scripts":{"lint":"eslint src","test":"vitest run","build":"tsc -p tsconfig.build.json","start":"node dist/index.js","format":"prettier --write .","prepare":"npm run build && prek install","typecheck":"tsc --noEmit","test:watch":"vitest","format:check":"prettier --check ."},"version":"0.8.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"1e8b5409-2a5b-4c52-99aa-448258ea718b"}},"homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","home-assistant","homeassistant","hass","home-automation","smart-home","automation","claude","ai-agents","llm","ai"],"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"_npmVersion":"11.21.0","description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","directories":{},"maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"_nodeVersion":"22.23.3","dependencies":{"ws":"^8.18.0","zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^10.4.1","vitest":"^4.1.0","prettier":"^3.8.3","@types/ws":"^8.5.12","@eslint/js":"^10.0.1","@j178/prek":"^0.4.4","typescript":"^5.8.3","@types/node":"^22.15.3","typescript-eslint":"^8.60.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/homeassistant-mcp_0.8.1_1791629667446_0.6957619091142968"}}},"time":{"created":"2026-06-06T17:36:30.167Z","modified":"2026-10-10T10:54:27.838Z","0.1.0":"2026-06-06T17:36:30.444Z","0.2.0":"2026-06-07T13:55:31.534Z","0.3.0":"2026-06-07T19:25:16.558Z","0.4.0":"2026-06-15T20:21:44.753Z","0.5.0":"2026-06-29T19:14:25.760Z","0.5.1":"2026-06-29T19:27:04.658Z","0.6.0":"2026-07-05T11:24:28.448Z","0.7.0":"2026-07-07T18:39:02.742Z","0.7.1":"2026-07-09T23:01:03.099Z","0.7.2":"2026-08-15T22:48:52.034Z","0.8.0":"2026-08-19T21:44:01.579Z","0.8.1":"2026-10-10T10:54:27.556Z"},"bugs":{"url":"https://github.com/OrellBuehler/homeassistant-mcp/issues"},"author":{"name":"Orell Bühler"},"license":"MIT","homepage":"https://github.com/OrellBuehler/homeassistant-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","home-assistant","homeassistant","hass","home-automation","smart-home","automation","claude","ai-agents","llm","ai"],"repository":{"url":"git+https://github.com/OrellBuehler/homeassistant-mcp.git","type":"git"},"description":"Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.","maintainers":[{"name":"orellbuehler","email":"orell.buehler@gmail.com"}],"readme":"# Home Assistant MCP Server\n\n[![npm](https://img.shields.io/npm/v/@orellbuehler/homeassistant-mcp.svg)](https://www.npmjs.com/package/@orellbuehler/homeassistant-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/@orellbuehler/homeassistant-mcp.svg)](https://www.npmjs.com/package/@orellbuehler/homeassistant-mcp)\n[![CI](https://github.com/OrellBuehler/homeassistant-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/OrellBuehler/homeassistant-mcp/actions/workflows/ci.yml)\n[![node](https://img.shields.io/node/v/@orellbuehler/homeassistant-mcp.svg)](https://nodejs.org)\n[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)\n\nA [Model Context Protocol](https://modelcontextprotocol.io/) server that turns your\n[Home Assistant](https://www.home-assistant.io/) instance into a safe workbench for AI agents —\nbuilt to **author and validate configuration and automations**, not to control your home.\n\nPoint Claude (or any MCP client) at it and the agent can:\n\n- **See what exists, live** — entities, services, events, areas, devices, labels, state history,\n  logbook.\n- **Author configuration** — create/edit automations, configure the Energy dashboard, manage\n  Zigbee (ZHA) groups, register Lovelace resources, prune HACS repositories, rename entities,\n  reload YAML domains.\n- **Validate its own work** — render Jinja2 templates against live state, run HA's config check,\n  read the error log, and inspect step-by-step execution traces of automations it wrote.\n- **Never touch your devices** — there is deliberately no `call_service`, no `set_state`, and no\n  `fire_event`. The agent writes config; it cannot turn anything on or off.\n\n43 tools, zero install (`npx`), works with Claude Code, Claude Desktop, Cursor, and any other MCP\nclient.\n\n## Example prompts\n\n> \"Create an automation that turns on the porch light 30 minutes before sunset, but only when\n> someone is home.\"\n\n> \"My 'goodnight' automation didn't fire last night. Figure out why.\"\n\n> \"Write a template sensor for net grid power and validate it against live state before I put it\n> in my YAML.\"\n\n> \"Set up my Energy dashboard: grid import/export from these two sensors, solar from the inverter,\n> and add every smart plug as an individual device.\"\n\n> \"Group the three living-room bulbs into one Zigbee group so they dim in sync.\"\n\n> \"I uninstalled a HACS card — find and remove the dangling Lovelace resource.\"\n\n## Install\n\nThe package is published as\n[`@orellbuehler/homeassistant-mcp`](https://www.npmjs.com/package/@orellbuehler/homeassistant-mcp)\nand runs directly with `npx` — no clone or build needed:\n\n```bash\nclaude mcp add homeassistant \\\n  --env HASS_URL=http://homeassistant.local:8123 \\\n  --env HASS_TOKEN=your-long-lived-access-token \\\n  -- npx -y @orellbuehler/homeassistant-mcp\n```\n\nSee [Usage with Claude Code](#usage-with-claude-code) for the equivalent JSON config. For any other\nMCP client, run the package directly — `npx -y @orellbuehler/homeassistant-mcp` with `HASS_URL` and\n`HASS_TOKEN` set in the environment. Requires Node.js 20+.\n\n## Getting a token\n\n`HASS_TOKEN` must be a **Long-Lived Access Token**:\n\n1. In Home Assistant, open your profile (click your username, bottom-left).\n2. Go to the **Security** tab → **Long-lived access tokens** → **Create token**.\n3. Copy the token (it is shown only once) and treat it like a password.\n\nThe token inherits your user's permissions. To limit what the agent can see, create a dedicated HA\nuser with the access you want and generate the token as that user.\n\n## Configuration\n\n| Variable      | Required | Description                                                                       |\n| ------------- | -------- | --------------------------------------------------------------------------------- |\n| `HASS_URL`    | yes\\*    | Base URL of your instance, e.g. `http://homeassistant.local:8123`. `https` works. |\n| `HASS_SERVER` | no       | Alias for `HASS_URL` (compatible with `hass-cli`). Used if `HASS_URL` is unset.   |\n| `HASS_TOKEN`  | yes      | Long-lived access token.                                                          |\n\n\\* Either `HASS_URL` or `HASS_SERVER` must be set. The WebSocket URL is derived automatically\n(`http`→`ws`, `https`→`wss`, plus `/api/websocket`).\n\n## Usage with Claude Code\n\nAdd the server to `~/.claude/settings.json` (or a project `.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"homeassistant\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@orellbuehler/homeassistant-mcp\"],\n      \"env\": {\n        \"HASS_URL\": \"http://homeassistant.local:8123\",\n        \"HASS_TOKEN\": \"your-long-lived-access-token\"\n      }\n    }\n  }\n}\n```\n\nIf you built from source instead, use `\"command\": \"node\"` with\n`\"args\": [\"/path/to/homeassistant-mcp/dist/index.js\"]`. Restart Claude Code and the tools are\navailable immediately. Verify with `claude mcp list` (should show `homeassistant ✓ connected`) or\n`/mcp` inside a session.\n\n## Tools\n\n43 tools in 12 groups. REST tools go through the\n[Home Assistant REST API](https://www.home-assistant.io/integrations/api/); WebSocket tools use the\nconfig registries that are not exposed over REST.\n\n**Entities & state** (REST)\n\n| Tool            | Description                                                            |\n| --------------- | ---------------------------------------------------------------------- |\n| `list_entities` | Compact summary of live entities (filter by `domain` and/or `search`). |\n| `get_entity`    | Full state object for one entity, including all attributes.            |\n| `list_domains`  | Distinct entity domains present, with counts.                          |\n\n**Services & events** (REST)\n\n| Tool            | Description                                                                         |\n| --------------- | ----------------------------------------------------------------------------------- |\n| `list_services` | Callable services (actions for automations/scripts). Pass `domain` for full fields. |\n| `list_events`   | Event types being listened for, with listener counts (for `event` triggers).        |\n\n**System & validation** (REST)\n\n| Tool              | Description                                                                    |\n| ----------------- | ------------------------------------------------------------------------------ |\n| `get_config`      | Running config: version, components, unit system, time zone, etc.              |\n| `check_config`    | Validate the YAML config on the server (`/api/config/core/check_config`).      |\n| `get_error_log`   | Error log as text (tail to `lines`, default 100).                              |\n| `render_template` | Render a Jinja2 template against live state — for template sensors/conditions. |\n\n**History** (REST)\n\n| Tool          | Description                                                |\n| ------------- | ---------------------------------------------------------- |\n| `get_history` | State history for one or more entities over a time window. |\n| `get_logbook` | Human-readable logbook entries.                            |\n\n**Reload** (REST, curated allowlist)\n\n| Tool     | Description                                                                                |\n| -------- | ------------------------------------------------------------------------------------------ |\n| `reload` | Reload a reloadable domain so YAML edits apply without a restart (`all`, `automation`, …). |\n\n**Automations** (REST, `/api/config/automation`)\n\n| Tool                    | Description                                                                    |\n| ----------------------- | ------------------------------------------------------------------------------ |\n| `get_automation_config` | Stored config (triggers/conditions/actions/mode) of one automation.            |\n| `upsert_automation`     | Create a new automation or replace an existing one's config (validated by HA). |\n| `delete_automation`     | Delete a UI-managed automation.                                                |\n\nAll three accept the `automation.*` entity id (the internal id is resolved automatically) or the\ninternal id itself. Writes require an **admin token**; HA validates the config, stores it in\n`automations.yaml` and reloads automations automatically. `upsert_automation` replaces the whole\nconfig, so edit via `get_automation_config` → modify → `upsert_automation`. Only automations with\nan `id` (UI-created / `automations.yaml`) are reachable — automations defined elsewhere in YAML are\nnot. Debug the result with the trace tools below.\n\n**Registries** (WebSocket)\n\n| Tool                     | Description                                                                              |\n| ------------------------ | ---------------------------------------------------------------------------------------- |\n| `list_registry_entities` | ALL registered entities, incl. disabled/unavailable (area, device, status).              |\n| `rename_entity`          | Set an entity's registry `name` and/or `new_entity_id` (config edit, no device control). |\n| `set_entity_enabled`     | Enable/disable entities in the registry (batch, per-entity results).                     |\n| `list_devices`           | Devices (id, name, manufacturer, model, area).                                           |\n| `list_areas`             | Areas (area_id, name, floor).                                                            |\n| `list_labels`            | Labels (label_id, name, color, icon).                                                    |\n\n`list_entities` (REST) shows entities that currently have state; `list_registry_entities`\n(WebSocket) shows everything registered, including disabled entities, with area/device grouping.\n`rename_entity` writes the registry via `config/entity_registry/update` (requires an admin token):\n`name` overrides the friendly name (null reverts to the integration's `original_name`) and\n`new_entity_id` renames the entity_id within the same domain.\n`set_entity_enabled` uses the same command (also admin-only) to set `disabled_by` to `null`\n(enable) or `\"user\"` (disable) for a batch of entity_ids; one failure does not abort the rest, and\neach entity comes back with its own `ok`/`error` and resulting `disabled_by`. Enabling is not\ninstant — HA loads the entity after its config entry reloads (`reload_delay`, usually 30 seconds) or\nafter a restart when the response sets `require_restart`.\n\n**Energy dashboard** (WebSocket)\n\n| Tool                      | Description                                                                         |\n| ------------------------- | ----------------------------------------------------------------------------------- |\n| `get_energy_prefs`        | Current Energy dashboard preferences (sources + the Individual-devices list).       |\n| `save_energy_prefs`       | Overwrite preferences (read-modify-write; replaces each provided key).              |\n| `add_energy_devices`      | Append entities to Individual devices, deduped, with optional eligibility warnings. |\n| `remove_energy_devices`   | Remove entities from Individual devices by `stat_consumption`.                      |\n| `validate_energy_prefs`   | Run `energy/validate` and correlate issues with each entity/source.                 |\n| `set_energy_grid_source`  | Set the single grid source (import/export plus optional cost/price stats).          |\n| `set_energy_solar_source` | Add or update a solar production source (upsert by `stat_energy_from`).             |\n\nThe Energy dashboard config lives in `.storage/energy` and is only reachable over WebSocket (not\nREST). The write tools (`save_energy_prefs`, `add_`/`remove_energy_devices`, `set_energy_*`) call\n`energy/save_prefs`, which **requires an admin token**. They are read-modify-write (fetch the current\nprefs, then save), so editing the Energy dashboard in the HA UI at the same moment can be overwritten\n— this is fine for the intended single-agent use.\n\n**Traces** (WebSocket, read-only)\n\n| Tool                 | Description                                                                         |\n| -------------------- | ----------------------------------------------------------------------------------- |\n| `list_traces`        | Recent execution traces (newest first) for an `automation.*`/`script.*` entity.     |\n| `get_trace`          | Full step-by-step trace for one run (config, variables, context, error).            |\n| `get_trace_contexts` | Map context ids to the trace run that produced them (causality across automations). |\n\nPass an `automation.*` or `script.*` entity id; the trace key is resolved automatically. Use these\nto debug **whether and how** an automation you authored actually ran.\n\n**ZHA / Zigbee groups** (WebSocket)\n\n| Tool                       | Description                                                                         |\n| -------------------------- | ----------------------------------------------------------------------------------- |\n| `list_zha_groups`          | Existing ZHA groups (group_id, name, members).                                      |\n| `list_zha_groupable`       | Endpoints that can join a group (ieee + endpoint_id + their entities).              |\n| `create_zha_group`         | Create a group on the coordinator; members by `entity_id` or `{ieee, endpoint_id}`. |\n| `add_zha_group_members`    | Add members to a group.                                                             |\n| `remove_zha_group_members` | Remove members from a group.                                                        |\n| `remove_zha_group`         | Delete group(s) by id (member devices untouched).                                   |\n\nA ZHA group lives on the Zigbee coordinator and is exposed to HA as one group entity (e.g. a single\n`light.*` that drives all members together via Zigbee multicast). This is **configuration\nauthoring**, not device control — like creating a helper, it changes what entities exist, not their\non/off state. The write tools call `zha/group/*` and **require an admin token**. Members must be\ngroupable ZHA endpoints (devices that support the Zigbee Groups cluster); `create_zha_group` /\n`add_zha_group_members` accept `entity_id`s and resolve them to `{ieee, endpoint_id}` via\n`list_zha_groupable`, or you can pass the `{ieee, endpoint_id}` pairs directly. The HA group entity\nis created asynchronously, so read its final `entity_id` from the entity registry afterwards.\n\n**Lovelace resources** (WebSocket)\n\n| Tool                       | Description                                                                |\n| -------------------------- | -------------------------------------------------------------------------- |\n| `list_lovelace_resources`  | Registered dashboard resources (id, type, url), e.g. `/hacsfiles/…`.       |\n| `create_lovelace_resource` | Register a JS/CSS URL loaded on every dashboard (defaults to module).      |\n| `update_lovelace_resource` | Change a resource's url and/or type by id.                                 |\n| `delete_lovelace_resource` | Remove a resource by id (e.g. the dangling one left after a HACS removal). |\n\nResources are the JS/CSS bundles loaded into every dashboard (Settings → Dashboards → Resources).\nThe write tools call `lovelace/resources/*`, **require an admin token**, and only work when the\nresource registry is in **storage mode** (`lovelace: mode: storage`); they are disabled if Lovelace\nis globally in YAML mode. This is config authoring, not device control.\n\n**HACS** (WebSocket)\n\n| Tool                     | Description                                                                     |\n| ------------------------ | ------------------------------------------------------------------------------- |\n| `list_hacs_repositories` | HACS repositories (installed-only by default): id, category, versions, paths.   |\n| `remove_hacs_repository` | Uninstall a repository by id — deletes its downloaded files and unregisters it. |\n\n`list_hacs_repositories` maps each repo to `id` + `local_path`/`file_name`, so you can tell which\n`/hacsfiles/…` Lovelace resource belongs to a plugin. `remove_hacs_repository` calls\n`hacs/repository/remove` (**admin token**) and deletes the plugin's files; when HACS manages\nresources (storage mode) it also drops the plugin's Lovelace resource for you, so verify with\n`list_lovelace_resources` and only `delete_lovelace_resource` one that's left behind. Removing an\nintegration you still reference in YAML will break that config, so check usage first.\n\n## Safety boundary\n\n- **No device control.** There is no generic `call_service`, no `set_state`, and no `fire_event`.\n  The server cannot turn things on/off.\n- **`reload` is restricted** to a fixed allowlist of `*.reload` / `homeassistant.reload_*` services.\n  It restarts reloadable domains (e.g. re-reads `automations.yaml`) but cannot control devices.\n- **Automation configs are writable** via the `/api/config/automation` REST API\n  (`upsert_automation` / `delete_automation`). This is the server's core purpose — authoring\n  automations — and needs an admin token. Be aware that an automation, once written, runs its\n  actions whenever its triggers fire, so review configs before writing. The server still cannot run\n  services directly: no `call_service`, `set_state`, or `fire_event`.\n- **Energy dashboard config is writable** via `energy/save_prefs` (the `*_energy_*` tools). This is\n  configuration authoring — the dashboard's sources and Individual-devices list — not device control,\n  and it needs an admin token. No `call_service`, `set_state`, or `fire_event` is added.\n- **ZHA groups are writable** via `zha/group/*` (the `*_zha_group*` tools). Creating/editing a Zigbee\n  group changes which group entities exist (config authoring), not any device's on/off state, and it\n  needs an admin token. Still no `call_service`, `set_state`, or `fire_event`.\n- **Lovelace resources are writable** via `lovelace/resources/*` (the `*_lovelace_resource` tools) —\n  which JS/CSS bundles load into dashboards. Config authoring, admin token, storage-mode only.\n- **HACS repositories are removable** via `hacs/repository/remove` (`remove_hacs_repository`). This\n  uninstalls a plugin/integration/theme and deletes its files (admin token); there is no install tool\n  (the server never downloads third-party code). Still no `call_service`, `set_state`, or `fire_event`.\n- **Read tools expose your home's data** (entity names, states, areas) to the agent/LLM. Use a\n  scoped HA user if that matters to you.\n- Prefer `https` and a trusted network path to your instance.\n\n## Development\n\n```bash\nnpm install\nnpm run build         # tsc -> dist/\nnpm test              # vitest run\nnpm run typecheck     # tsc --noEmit\nnpm run lint          # eslint src\nnpm run format:check  # prettier --check .\n```\n\nRun a single test file:\n\n```bash\nnpx vitest run src/__tests__/entities.test.ts\n```\n\n## CI / Releasing\n\n- **CI** (`.github/workflows/ci.yml`) runs on every push to `main` and on pull requests:\n  `format:check`, `lint`, `typecheck` (once) and `test` + `build` on Node 20 and 22.\n- **Publish** (`.github/workflows/publish.yml`) runs when a GitHub Release is published. It builds,\n  tests, and publishes to npm using [trusted publishing](https://docs.npmjs.com/trusted-publishers)\n  (OIDC) — **no `NPM_TOKEN` secret required**, with provenance generated automatically. It skips\n  publishing if that version is already on npm.\n\nOne-time setup on npmjs.com: open the package's **Settings → Trusted Publisher** and add a GitHub\nActions publisher for repository `OrellBuehler/homeassistant-mcp` with workflow `publish.yml`. If the\npackage doesn't exist on npm yet, do one manual `npm publish --access public` (after `npm login`) to\ncreate it, then add the trusted publisher for all future releases.\n\nCut a release:\n\n```bash\nnpm version patch          # bumps package.json + creates a vX.Y.Z tag (use minor/major as needed)\ngit push --follow-tags\ngh release create \"v$(node -p \"require('./package.json').version\")\" --generate-notes\n```\n\n## License\n\n[MIT](./LICENSE) © Orell Bühler\n","readmeFilename":"README.md"}