# homeassistant-mcp-server

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 207 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/homeassistant-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/homeassistant-mcp-server

## What it 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.

## Requirements
- Works with: Home Assistant

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/homeassistant-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/homeassistant-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/homeassistant-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/homeassistant-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/homeassistant-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/homeassistant-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/homeassistant-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/homeassistant-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill homeassistant-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/homeassistant-mcp-server/SKILL.md

## When to use it
- 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
- 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

## Similar
- [mcp-hass](https://affpapa.org/en/nevibecode/skills/mcp-hass.md) — skill · 3200 installs
- [Home Assistant Automation](https://affpapa.org/en/nevibecode/skills/home-assistant-automation.md) — skill · 5100 installs
- [home-assistant](https://affpapa.org/en/nevibecode/skills/home-assistant.md) — skill · ★ 173 repo stars
- [home-assistant-best-practices](https://affpapa.org/en/nevibecode/skills/home-assistant-best-practices.md) — skill · 9500 installs
- [ha-mcp](https://affpapa.org/en/nevibecode/mcp/ha-mcp.md) — MCP server · ★ 8042 repo stars
- [home-assistant-mcp](https://affpapa.org/en/nevibecode/mcp/home-assistant-mcp.md) — MCP server · ★ 58 repo stars

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
