homeassistant-mcp-server — Claude Code skill: what it does & install
homeassistant-mcp-server connects AI coding assistants to Home Assistant via MCP. Lets you monitor sensors, adjust climate, and manage smart appliances from the workspace.
no license 207 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a claude-codeWhat homeassistant-mcp-server does
Built on Python with FastMCP, this server exposes 40 tools covering climate units, media players, motorized covers, locks, and lighting. Rather than flooding the context window with every schema, it provides an on-demand discovery mechanism ranked by BM25. The assistant looks up relevant actions and loads only the schema it needs.
All operations are asynchronous and use TTL-based caching: 30 seconds for bulk entity listings and 10 seconds for single-device queries. This prevents repetitive calls from hammering the local hub.
Without valid HASS_HOST and HASS_TOKEN environment variables, the server fails authorization immediately.
What it helps with
- adjust smart lighting brightness and RGB colors from prompt instructions
- query entity states across Home Assistant domains without leaving the editor
- dispatch vacuum cleanups and alter suction modes
- open or tilt window blinds and control motorized covers
Example prompts for the agent
- Turn on the bedroom light and set warm white color temperature
- Check if the garage door is closed and list temperature sensors
- Start the hallway vacuum with turbo fan speed
How to install homeassistant-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/homeassistant-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/homeassistant-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a codex2Manually: put the files in place
.agents/skills/homeassistant-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/homeassistant-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/homeassistant-mcp-server2Manually: put the files in place
.github/skills/homeassistant-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/homeassistant-mcp-serverManually: put the files in place
.devin/skills/homeassistant-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about homeassistant-mcp-server
How to install homeassistant-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a claude-code in your terminal.
What configuration is required to run the server?
You need to export HASS_HOST with your local hub address and HASS_TOKEN with a long-lived access token created in Home Assistant.
Why does the server use BM25 search?
It keeps prompt context lean. Instead of sending 40 tool schemas on every turn, it exposes 8 discovery tools so the model requests specific tools as needed.