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
Setup
Choose your client, copy the config, then fill in any required environment variables.
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>"
}
}
}
}Environment variables
HA_AGENT_URLHA_AGENT_KEY
Replace the placeholders with your own credentials and keep them out of version control.