MCP
Home Assistant MCP
让 AI 查看家中设备状态，并操作你授权开放的智能家居设备。
适用对象：Home Assistant。原作者资料整理。
用 Codex 查询 Home Assistant 设备
按来源文档整理的具体步骤，本站尚未在此配对环境实机运行。
适用系统：macos、windows、linux。教程整理：2026-11-09。
准备条件
- 已有可访问的 Home Assistant 和已经接入的设备。
- Codex CLI 已安装并登录；需要能从当前机器访问 Home Assistant 地址。
- 在 Home Assistant 中确认开放的工具集：Device control 与可读取更多信息的 Home Assistant 工具集范围不同。首次仅使用必要范围。
接入步骤
- 在 Home Assistant 打开 Settings → System → AI，启用 Model Context Protocol 并复制要使用的 MCP URL。
- 在工具集设置中确认开放范围。Device control 只见到已开放实体；其他工具集可能能读更多实体、日志和历史。
- 把命令中的 <your_mcp_server_url> 换成刚复制的地址，再在自己的终端添加连接。
- 按 Codex 提示在浏览器登录 Home Assistant 授权；需要时运行登录命令。
- 列出 MCP 配置并检查连接；首次只查询设备状态，不执行控制。
添加连接 · 先替换地址占位符
使用前替换占位符；本站不收集访问令牌或设备密码。
codex mcp add homeassistant --url <your_mcp_server_url>需要 OAuth 时登录
codex mcp login homeassistant检查已配置服务器
codex mcp list第一次小任务
请仅查询我已授权的灯，列出名称和当前开关状态。不要改变设备状态；无法读取时说明具体错误。
怎样核对结果
- Codex 中存在 homeassistant 配置，认证已完成。
- 返回的设备名称和状态与 Home Assistant 中对应实体一致。
- 没有更改任何设备状态。
遇到问题
无法访问地址
确认当前机器能在浏览器打开 Home Assistant，MCP URL 取自当前实例；本地机器与云端 AI 的网络可达条件不同。
反复 OAuth 失败
按 Home Assistant 官方排错核对 URL 与实例认证配置，重新完成登录；不要把访问令牌粘贴到本站。
设备不可见或范围超出预期
核对所用工具集及实体开放范围，先在 Home Assistant 调整权限再试；同步成功并不证明权限正确。
如何停用
- 在自己的终端运行 codex mcp remove homeassistant 移除该客户端配置；如需撤销访问，再到 Home Assistant 检查授权。