Home Assistant MCP (homeassistant-ai)
Home Assistant MCPサーバー(homeassistant-ai版)でClaude連携・スマートホーム管理を自動化
uvx ha-mcp概要
Home Assistant MCP(homeassistant-ai/ha-mcp 版)の設定方法と使い方。
セルフホスト型スマートホームプラットフォーム「Home Assistant」をClaudeから操作できるMCPサーバーの別実装。
デバイス制御・オートメーション作成・ダッシュボード編集・トラブルシューティング用ツールを提供する。
ClaudeとHome AssistantのMCPサーバー連携により、自然言語での照明・家電制御や、動かないオートメーションのデバッグといった日常運用を自動化できる。
設定方法は uvx ha-mcp に Home Assistant の URL とロングリブドトークンを渡すだけでシンプルに完結する。
料金・APIキー情報
料金
完全無料APIキー
🔑 必要🔑 APIキーの取得方法
- 1
Home Assistant の UI で右下の自分のアイコン → プロファイルを開く
- 2
「Long-Lived Access Tokens」セクションへ移動する
- 3
「Create Token」をクリックしてトークン名を入力する
- 4
発行されたトークンを安全に保存する(一度しか表示されないため必須)
こんな使い方ができます
「日の入り時刻に玄関灯を点ける」のような自動化をClaudeに作成・設定させられる
ダッシュボードに天気カードを追加するなど画面構成をClaudeに変更させられる
動いていないオートメーションをClaudeにデバッグさせられる
センサー履歴をもとにClaudeに最適なオートメーションを提案させられる
セットアップ手順
- 1
Home Assistant の URL とロングリブドアクセストークンを用意する
- 2
uv(Python パッケージマネージャ)をインストールする
- 3
Claude Code に追加:claude mcp add ha-mcp -- uvx ha-mcp
- 4
ha-mcp の README に従い HA_URL / HA_TOKEN などの環境変数を設定する
設定ファイル
コピー前に確認
Home Assistant(ローカル or Nabu Casa等のリモート)への接続情報と、ロングリブドアクセストークンが必要。uvx / pip / Docker / macOS/Windowsクイックインストールスクリプトに対応。
claude mcp add ha-mcp -- uvx ha-mcp注意事項
既存掲載の voska/hass-mcp とは別メンテナー(homeassistant-ai)の別実装。Python(uvx)ベースで配布されており、自動化作成・ダッシュボード編集・デバッグなど運用フォーカスのツール群が強み。MITライセンス。