Model Context Protocol Server for Home Assistant

A MCP server for Home Assistant

Catalog onlyCatalog onlySTDIO

Overview

Home Assistant MCP is a Model Context Protocol server designed to facilitate access to a local Home Assistant instance for use with large language model (LLM) applications.

First, build the server using yarn build. Then, configure your application (such as Claude Desktop) to utilize the MCP server by providing a personal access token and base URL for Home Assistant.

Enables integration between Home Assistant and LLM applications via the MCP protocol. - Provides access to various entities, floors, and areas within Home Assistant. - Supports further control functionalities for lights, thermostats, and more when fully implemented.

Integrating smart home functionalities with conversational AI applications.
Accessing and controlling smart devices through a text-based interface.
Enabling context-aware interactions with home automation.

Add to your AI client

Use these steps to connect Model Context Protocol Server for Home Assistant in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "homeassistant-mcp-tevonsb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-homeassistant-mcp-tevonsb"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "homeassistant-mcp-tevonsb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-homeassistant-mcp-tevonsb"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "homeassistant-mcp-tevonsb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-homeassistant-mcp-tevonsb"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "homeassistant-mcp-tevonsb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-homeassistant-mcp-tevonsb"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "homeassistant-mcp-tevonsb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-homeassistant-mcp-tevonsb"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "homeassistant-mcp-tevonsb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-homeassistant-mcp-tevonsb"
      ]
    }
  }
}

FAQ

What do I need to run Home Assistant MCP?

You need to set up Home Assistant and obtain a personal access token to configure the server.

Can I control devices with Home Assistant MCP?

Currently, the server allows access to entities; full control features for devices are still in development.

Is there documentation available for Home Assistant?

Yes! You can find comprehensive documentation at https://www.home-assistant.io.

Developer tools