mcp-server-home-assistant

A Model Context Protocol Server for Home Assistant

GitHub Stars

61

User Rating

Not Rated

Favorites

0

Views

26

Forks

8

Issues

5

Installation
Difficulty
Beginner
Estimated Time
5-10 minutes

Installation

Installation

Prerequisites

Please specify required software and versions:
Python: 3.8 or higher
Home Assistant: Latest version

Installation Steps

1. Clone Repository

bash
git clone https://github.com/allenporter/mcp-server-home-assistant.git
cd mcp-server-home-assistant

2. Install Dependencies

bash
pip install -r requirements.txt

3. Configure Claude Desktop

Edit claude_desktop_config.json to add the MCP server:
json
{
  "mcpServers": {
    "Home-assistant": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-home-assistant",
        "run",
        "mcp-server-home-assistant",
        "-v",
        "-v"
      ],
      "env": {
        "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket",
        "HOME_ASSISTANT_API_TOKEN": "your_api_token"
      }
    }
  }
}

4. Start Server

bash
uv run mcp-server-home-assistant -v -v

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Python version and reinstall dependencies. Issue: Not recognized by Claude Desktop Solution: Verify configuration file path and syntax.