Home Assistant MCP server agent. Enable Claude Code, Cursor, VS Code or any MCP-enabled IDE to help you vibe-code and manage Home Assistant: create and debug automations, design dashboards, tweak themes, modify configs, and deploy changes using natural language
接入配置
选择客户端,复制配置,再按项目文档补齐环境变量。
claude mcp add ha-cursor-agent-home-assistant-add-on --env HA_AGENT_URL='<HA_AGENT_URL>' --env HA_AGENT_KEY='<HA_AGENT_KEY>' -- npx -y @coolver/home-assistant-mcp@latest~/.codex/config.toml
[mcp_servers.ha-cursor-agent-home-assistant-add-on]
command = "npx"
args = ["-y", "@coolver/home-assistant-mcp@latest"]
env = { HA_AGENT_URL = "<HA_AGENT_URL>", HA_AGENT_KEY = "<HA_AGENT_KEY>" }
# codex mcp add ha-cursor-agent-home-assistant-add-on --env HA_AGENT_URL='<HA_AGENT_URL>' --env HA_AGENT_KEY='<HA_AGENT_KEY>' -- npx -y @coolver/home-assistant-mcp@latest~/.cursor/mcp.json
{
"mcpServers": {
"ha-cursor-agent-home-assistant-add-on": {
"command": "npx",
"args": [
"-y",
"@coolver/home-assistant-mcp@latest"
],
"env": {
"HA_AGENT_URL": "<HA_AGENT_URL>",
"HA_AGENT_KEY": "<HA_AGENT_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"ha-cursor-agent-home-assistant-add-on": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@coolver/home-assistant-mcp@latest"
],
"env": {
"HA_AGENT_URL": "<HA_AGENT_URL>",
"HA_AGENT_KEY": "<HA_AGENT_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"ha-cursor-agent-home-assistant-add-on": {
"command": "npx",
"args": [
"-y",
"@coolver/home-assistant-mcp@latest"
],
"env": {
"HA_AGENT_URL": "<HA_AGENT_URL>",
"HA_AGENT_KEY": "<HA_AGENT_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"ha-cursor-agent-home-assistant-add-on": {
"command": "npx",
"args": [
"-y",
"@coolver/home-assistant-mcp@latest"
],
"env": {
"HA_AGENT_URL": "<HA_AGENT_URL>",
"HA_AGENT_KEY": "<HA_AGENT_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"ha-cursor-agent-home-assistant-add-on": {
"command": "npx",
"args": [
"-y",
"@coolver/home-assistant-mcp@latest"
],
"env": {
"HA_AGENT_URL": "<HA_AGENT_URL>",
"HA_AGENT_KEY": "<HA_AGENT_KEY>"
}
}
}
}需要的环境变量
HA_AGENT_URLHA_AGENT_KEY
把占位值换成你自己的密钥;不要把密钥提交到代码仓库。