Home Assistant MCP Server

概要

ha-mcp (非公式で最高の Home Assistant MCP サーバー) は、コミュニティによって構築された主要な Model Context Protocol サーバーであり、あなたの Home Assistant インスタンスを AI アシスタントのための強力なツールへと変えます。Claude、Cursor、Gemini CLI などの LLM や、MCP 互換の任意のクライアントが、自然言語を使って直接あなたのスマートホームと対話できるようにします。

現在、Home Assistant には公式の mcp_server インテグレーションが含まれていますが、ha-mcp はより豊富な機能（80以上のツール）、簡単な HA OS アドオン、専用のセットアップウィザードを提供しており、大多数のユーザーにとって第一選択肢となっています。

主な特徴

• 自然言語制御: ライトのオン/オフ、気候調整、カバーの開閉、メディア再生、任意のサービスの実行が可能です。
• リアルタイム状態 & エンティティ照会: センサー値、デバイス状態、家庭全体の概要を尋ねることができます。
• オートメーション管理: オートメーションの作成、編集、有効化/無効化、トリガー、一時停止を動的に行えます。
• 高度な機能: YAML 編集、HACS 管理、Lovelace ダッシュボード生成、更新処理、バックアップ、80以上の専門的なツールを備えています。
• マルチクライアント対応: Claude Desktop、Cursor、VS Code + Cline、Gemini CLI などとシームレスに連携します。
• 簡単なインストール: 公式 HA OS アドオン、Docker、クイックランオプションが利用できます。
• 安全 & 信頼性: 適切な認証を伴う長寿命アクセストークンを使用します。

ユースケース

• ハンズフリー・スマートホーム: 「階下のすべての照明を消して、玄関のドアを施錠して」
• AI 駆動オートメーション: 「日没にポーチライトを点灯し、通知を送るオートメーションを作成して」
• ダッシュボード & 設定編集: Cursor や Claude に Lovelace ダッシュボードや YAML 設定を生成・デプロイさせることができます。
• モニタリング & トラブルシューティング: 「寝室の現在の温度は？なぜモーションセンサーがオフラインなの？」
• 複雑なワークフロー: 他の MCP サーバーと組み合わせて、AI による完全なホーム + 開発パイプラインを実現できます。

インストール（最も簡単な方法）

Home Assistant OS アドオン

1. HA アドオンストアにリポジトリ https://github.com/homeassistant-ai/ha-mcp を追加します。
2. Home Assistant MCP Server アドオンをインストールして起動します。
3. 長寿命アクセストークンを生成し、設定します。
4. 公式セットアップウィザードを使用します: https://homeassistant-ai.github.io/ha-mcp/setup/

代替オプション: Docker、uvx、またはリポジトリからの手動インストール。

互換性

• クライアント: Claude Desktop、Cursor、Gemini CLI、Codex、任意の MCP 準拠アプリケーション。
• Home Assistant: 現在の HA バージョン（OS、コンテナ、コア）で動作します。
• ライセンス: オープンソース (詳細な条件はリポジトリを確認してください)。

コミュニティと代替手段

これは最も活発にメンテナンスされ、機能豊富なバージョンです（2026年3月現在、v7.1.0以降）。他のコミュニティフォークも存在しますが、homeassistant-ai組織によるha-mcpは、フォーラム、YouTube、Redditで最も推奨されているものです。

公式のHome Assistant mcp_server統合も、より軽量なユースケースに利用可能です。

AIを使ってスマートホームを操作しましょう — ha-mcpはそれをシンプルに、強力に、楽しく実現します。