Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/homeassistant-mcp-server/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/homeassistant-mcp-server/

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.

Similar skills

All skills for Automation and no-code: n8n, Zapier, Make →

From the same set98

The whole set →
ida-no-mcp-decompiler-exporter The ida-no-mcp-decompiler-exporter skill prepares IDA Pro exports for AI review, including decompiled functions, fallback assembly, strings, tables, and memory dumps. CX Codex +1 211installs godot-mcp-native godot-mcp-native is a Claude Code skill that connects an AI assistant to a Godot project over MCP. It can inspect scenes, change scripts and work with the editor. CX Codex +1 209installs cheatengine-mcp-automation cheatengine-mcp-automation lets an AI agent drive Cheat Engine over MCP: scan process memory, chase pointer chains, dissect structs and set breakpoints from a prompt. CX Codex +1 208installs idea-reality-mcp-validation The idea-reality-mcp-validation skill checks an idea for similar projects through an MCP tool, then returns competitors and trend signals. Use it before you start building. CX Codex +1 207installs kagi-session2api-mcp-server The kagi-session2api-mcp-server skill guides setup of a Kagi MCP server for web searches and URL summaries. Use it when you want an agent to find online sources or condense an article. CX Codex +1 207installs datagouv-mcp-server The datagouv-mcp-server skill lets an agent search and inspect French open-data datasets through the data.gouv.fr MCP server. Use it for dataset, organization, and resource questions. CX Codex +1 206installs stitch-mcp-cli stitch-mcp-cli brings Google Stitch UI designs into local dev workflows. Runs dev server previews, builds Astro sites, and feeds screens to coding agents via MCP. CX Codex +1 205installs universal-db-mcp-connector The universal-db-mcp-connector skill stands up an MCP server against your database, so the assistant writes and runs queries itself. It covers 17 database types, among them MySQL, PostgreSQL and MongoDB. CX Codex +1 203installs

More in the catalog

Project sponsors

Companies that keep this analytics open