Home Assistant Model Context Protocol (MCP)

What is Home Assistant Model Context Protocol (MCP)?

The Home Assistant Model Context Protocol (MCP) server connects AI assistants like Claude, GPT, Cursor, and Copilot to a Home Assistant instance. It provides over 50 tools to control smart home devices, support for three transport methods, and local voice control features, targeting both developers and smart home enthusiasts.

How to use Home Assistant Model Context Protocol (MCP)?

Install via bunx, npx, Docker, npm global, or Smithery. Configure with HASS_HOST and HASS_TOKEN environment variables. Use with Claude Desktop, Cursor, VS Code, or any MCP client. Start with one command: bunx github:jango-blockchained/advanced-homeassistant-mcp.

Key features of Home Assistant Model Context Protocol (MCP)

• 50+ tools for lights, climate, media, locks, and vacuums
• Three transports: STDIO, HTTP+WS, and HTTP fastmcp
• Supports Claude Desktop, Cursor, VS Code, and Smithery
• Speech features with wake word and speech-to-text
• Energy monitoring, maintenance, and automation management
• Full-text entity search and history queries

Use cases of Home Assistant Model Context Protocol (MCP)

• Voice-controlled smart home via AI assistants
• Automate scenes, notifications, and device management
• Monitor energy consumption and identify orphaned devices
• Remotely control Home Assistant through chat interfaces
• Debug automations with trace queries and error logs

FAQ from Home Assistant Model Context Protocol (MCP)

What do I need to run it?

A Home Assistant instance and a long-lived access token from your account profile.

How do I install it?

Use bunx, npx, Docker, npm global, or Smithery one‑click install. See the Quick Start section for details.

What transports are supported?

STDIO for local editor integrations (Claude Desktop, Cursor, VS Code) and HTTP+WS for remote AI hosts with JWT auth, plus HTTP via fastmcp.

Can I control voice?

Yes, with the speech features Docker Compose file, using wyoming‑openwakeword for wake word and faster‑whisper for speech‑to‑text.

Where does the data live?

All communication happens between the AI assistant and your Home Assistant instance; no external cloud storage is required.