homeassistant-mcp-server

Control Home Assistant smart home devices through Model Context Protocol tools.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/Aradotso/mcp-skills --skill homeassistant-mcp-server
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homeassistant-mcp-server
Source: https://github.com/Aradotso/mcp-skills/tree/main/skills/homeassistant-mcp-server
Command: npx skills add https://github.com/Aradotso/mcp-skills --skill homeassistant-mcp-server

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the friction of manually operating Home Assistant smart home devices by letting you control them through an AI assistant using MCP.

Core Features & Use Cases

  • Device control with AI-friendly tools: Turn lights on/off, set brightness and color, control climate, covers, locks, media players, and vacuums using a structured MCP toolset.
  • Context-efficient tool discovery: Use discovery and BM25 search so the assistant finds only the relevant tools and keeps MCP context lean.
  • State, services, and automation management: Query entity/device state via MCP resources, call Home Assistant services, and trigger/enable/disable automations, plus access history and logs when needed.

Quick Start

Configure your MCP client to connect to the Home Assistant MCP server by setting HASS_HOST and HASS_TOKEN, then ask your assistant to turn on a specific light entity (for example: “Turn on light.living_room to 80% brightness”).

Frequently Asked Questions about homeassistant-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control my Home Assistant smart home devices using an AI assistant?

You can control Home Assistant devices by connecting your AI assistant via Model Context Protocol, enabling structured tool calls to manage lights, climate, locks, media, vacuums, and covers through natural language commands.

Can I trigger automations and scenes in Home Assistant through MCP?

Yes, Home Assistant MCP supports triggering, enabling, and disabling automations and scenes. It also allows querying entity states via read-only resources and calling Home Assistant services for comprehensive smart home automation management.

What do I need to configure before connecting an AI assistant to Home Assistant?

You need a valid Home Assistant host URL and a long-lived access token. Configure your MCP client with these credentials using the HASS_HOST and HASS_TOKEN variables to establish the connection for device control.

How does the AI find the right smart home tools without bloating the context window?

The system uses BM25-ranked tool discovery to search and retrieve only the relevant smart home tools. This context-efficient mechanism keeps the AI's context lean while ensuring precise device control and state querying.

Does this Home Assistant MCP server support asynchronous operations?

Yes, it uses FastMCP-based async execution to efficiently handle read-only resource access and device control commands. This ensures responsive smart home automation and state querying without blocking operations.

What smart home domains can I manage through the Model Context Protocol?

You can manage common smart home domains including lights, climate, covers, locks, media players, and vacuums. The AI assistant can turn devices on or off, set brightness and color, and trigger automations across these categories.