drio
Open app

Home Assistant MCP Server

Source

home-assistant-mcp-server

Catalog onlyCatalog onlySTDIO

Overview

Home Assistant MCP Server is a Model Context Protocol (MCP) server designed to integrate with Home Assistant, enabling large language models (LLMs) to control and query smart home devices using natural language.

To use the Home Assistant MCP Server, install it globally or from source, configure the necessary environment variables, and run the server. It can be integrated with compatible clients like Claude Desktop for enhanced functionality.

  • Natural language querying and control of Home Assistant entities - Compatibility with any MCP-compatible client - Tools for state management, service calls, and historical data access - Secure authentication with long-lived access tokens - Multiple transport options including stdio and SSE - Demo mode for testing without a live Home Assistant instance
  1. Enabling voice control for smart home devices through LLMs.
  2. Automating home management tasks via natural language commands.
  3. Testing and demonstrating smart home setups without needing a live connection.

Add to your AI client

Use these steps to connect Home Assistant MCP Server 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": {
    "home-assistant-mcp-server-oleander": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-home-assistant-mcp-server-oleander"
      ]
    }
  }
}

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": {
    "home-assistant-mcp-server-oleander": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-home-assistant-mcp-server-oleander"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

{
  "mcpServers": {
    "home-assistant-mcp-server-oleander": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-home-assistant-mcp-server-oleander"
      ]
    }
  }
}

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "home-assistant-mcp-server-oleander": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-home-assistant-mcp-server-oleander"
      ]
    }
  }
}

Cline

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

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "home-assistant-mcp-server-oleander": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-home-assistant-mcp-server-oleander"
      ]
    }
  }
}

FAQ

**What is the purpose of the Home Assistant MCP Server?**

It allows LLMs to interact with and control smart home devices using natural language.

**How do I install the Home Assistant MCP Server?**

You can install it globally using bun or clone the repository and install from source.

**Is there a demo mode available?**

Yes, the server can run in demo mode with mock data when Home Assistant is not available.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2288,"uuid":"e8dc937b-588b-4dbe-b588-fc6f632dbc0e","name":"home-assistant-mcp-server","title":"Home Assistant MCP Server","description":"home-assistant-mcp-server","avatar_url":"https://avatars.githubusercontent.com/u/220827?v=4","created_at":"$D2025-03-09T07:22:59.309Z","updated_at":"$D2025-03-12T10:21:15.380Z","status":"created","author_name":"oleander","author_avatar_url":"https://avatars.githubusercontent.com/u/220827?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/oleander/home-assistant-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"1\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-06 14:04:41\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools