# mcp-server-home-assistant

> MCP Server

This repository provides a Model Context Protocol server for Home Assistant, enabling integration with Claude Desktop by using a custom component and a long-lived access token for communication.

## Overview

- **Category:** System Tools
- **Language:** Python
- **Stars:** 68
- **Forks:** 2
- **Owner:** allenporter
- **GitHub:** https://github.com/allenporter/mcp-server-home-assistant
- **Homepage:** https://allenporter.github.io/mcp-server-home-assistant/
- **Created:** 2024-11-27T03:00:15+00:00
- **Updated:** 2025-03-28T07:29:50+00:00
- **Source:** https://model-context-protocol.com/servers/model-context-protocol-server-home-assistant

## Setup

## Setup

1. Install the [home-assistant-model-context-protocol](https://github.com/allenporter/home-assistant-model-context-protocol) custom component in your Home Assistant instance.
2. Create a [Long Lived Access Token](https://www.home-assistant.io/docs/authentication/#your-account-profile).
3. Clone this git repo to a path like `/Users/allen/Development/mcp-server-home-assistant`.
4. Edit your `claude_desktop_config.json` with the provided configuration, including your Home Assistant URL and API token.
5. View the logs e.g. `~Library/Logs/Claude/mcp-server-Home-assistant.log` to understand what is happening.

## Tools

## Available Tools

1. Model Context Protocol Server (Provides context to Claude Desktop from Home Assistant)
2. `home-assistant-model-context-protocol` custom component (Required for Home Assistant integration)
3. Long Lived Access Token (Used for authentication with Home Assistant)