Home AssistantとClaudeや他のLLMとの統合のためのモデルコンテキストプロトコル(MCP)サーバーです。

概要

Hass-MCPは、ClaudeのようなAIアシスタントがあなたのHome Assistantインスタンスと直接やり取りできるようにし、以下のようなことができます。

• デバイスおよびセンサーの状態を照会する
• 制御ライト、スイッチ、その他のエンティティ
• スマートホームの概要を取得する
• 自動化やエンティティのトラブルシューティング
• 特定の実体を検索する
• 共通のタスクに対するガイド付き会話の作成

スクリーンショット

特徴

• エンティティ管理:状態取得、デバイスの制御、エンティティの検索
• ドメイン概要:エンティティの種類に関する高レベルの情報を得る
• 自動化サポート:リストおよび制御自動化
• ガイド付き会話:自動化作成など一般的なタスクにプロンプトを使う
• スマート検索:名前、タイプ、または状態でエンティティを検索
• ライブダッシュボード編集:Home AssistantのWebSocket API上でLovelaceダッシュボード(カードやビュー)を読み書き編集できます。変更は開いたブラウザに即座に表示され、自動バックアップと予告プレビューが行われます
• トークン効率:トークン使用を最小限に抑えるリーンJSON応答

設置

前提条件

Hass-MCP

A Model Context Protocol (MCP) server for Home Assistant integration with Claude and other LLMs.

Overview

Hass-MCP enables AI assistants like Claude to interact directly with your Home Assistant instance, allowing them to:

• Query the state of devices and sensors
• Control lights, switches, and other entities
• Get summaries of your smart home
• Troubleshoot automations and entities
• Search for specific entities
• Create guided conversations for common tasks

Screenshots

Features

• Entity Management: Get states, control devices, and search for entities
• Domain Summaries: Get high-level information about entity types
• Automation Support: List and control automations
• Guided Conversations: Use prompts for common tasks like creating automations
• Smart Search: Find entities by name, type, or state
• Live Dashboard Editing: Read and edit Lovelace dashboards (cards and views) over Home Assistant’s WebSocket API — changes appear instantly in open browsers, with automatic backups and a dry-run preview
• Token Efficiency: Lean JSON responses to minimize token usage

Installation

Prerequisites

• Home Assistant instance with Long-Lived Access Token
• One of the following:
  • Docker (recommended)
  • Python 3.13+ and uv

Setting Up With Claude Desktop

Docker Installation (Recommended)

1. Pull the Docker image:

   docker pull voska/hass-mcp:latest
   

2. Add the MCP server to Claude Desktop:

   a. Open Claude Desktop and go to Settings b. Navigate to Developer > Edit Config c. Add the following configuration to your claude_desktop_config.json file:

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "HA_URL",
           "-e",
           "HA_TOKEN",
           "voska/hass-mcp"
         ],
         "env": {
           "HA_URL": "http://homeassistant.local:8123",
           "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN"
         }
       }
     }
   }
   

   d. Replace YOUR_LONG_LIVED_TOKEN with your actual Home Assistant long-lived access token