概要
AI に Home Assistant を読み取らせましょう。すべてのセンサー、照明、ドア、サーモスタットの現在の状態、記録された履歴、いつ何が起きたかを示すログブック、そしてカレンダーを参照できます。読み取り専用で、デバイスを操作することはありません。セルフホストの Home Assistant に対応しています。
ガイド付きセットアップ
Home Assistant を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Home Assistant を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Home Assistant のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要。cloud.anythingmcp.com をそのままご利用いただけます。 サインインして Connectors → Home Assistant をクリックし、認証情報を貼り付けて MCP API キーを発行するだけです。Docker も
git cloneもローカルサーバーも不要です。
Home Assistant
AI に Home Assistant を読み取らせましょう。すべてのセンサー、照明、ドア、サーモスタットの現在の状態、記録された履歴、いつ何が起きたかを示すログブック、そしてカレンダーを参照できます。読み取り専用で、デバイスを操作することはありません。セルフホストの Home Assistant に対応しています。
セットアップ
セットアップには約 3 分かかります。AnythingMCP から到達できる Home Assistant インスタンスと、長期アクセストークン(できれば管理者権限のない専用ユーザーのもの)が必要です。
HOME_ASSISTANT_URLに、Home Assistant を開くアドレスを設定します。末尾のスラッシュと/apiは付けません。例:https://home.example.comやhttp://192.168.1.10:8123(デフォルトのポートは 8123 です)。- 推奨: Settings → People → Users → Add user で AnythingMCP 専用の Home Assistant ユーザーを作成し、Administrator をオフにします。コネクタが使用するエンドポイントに管理者権限は必要ありません。
- そのユーザーでログインし、左下の自分の名前をクリックしてプロフィールを開きます。Security タブを開き、Long-lived access tokens の Create token をクリックします。トークンをコピーし(一度だけ表示され、有効期間は 10 年です)、Bearer という単語を付けずに
HOME_ASSISTANT_TOKENに貼り付けます。 - コネクタをインストールして
home_assistant_get_configを実行します。バージョン、ロケーション名、タイムゾーンが返され、アドレスとトークンが正しく動作することを確認できます。
読み取れる内容: すべてのエンティティ(センサー、照明、空調、ドア、在宅状況)の現在の状態と属性、ある期間にわたる値の記録された履歴、いつ何が起きたかを示すログブック(たとえばガレージのドアが最後に開いた時刻)、カレンダーとそのイベント、そしてインスタンスの設定です。エンティティ ID は sensor.living_room_temperature や binary_sensor.garage_door のような形式です。
読み取り専用: すべてのツールは GET リクエストです。コネクタはアクション(サービス)の呼び出し、オン/オフの切り替え、ドアの解錠、スクリプトの実行、状態の変更を行えません。Home Assistant 自体のアクションエンドポイントは管理者専用ではないため、この保証はトークンではなく、コネクタが読み取りのみを公開していることによるものです。
Home Assistant の稼働場所: セルフホストの AnythingMCP では、プライベートネットワーク上のインスタンス(http://192.168.x.x:8123、homeassistant.local)を利用するには、管理者が SSRF_ALLOWED_HOSTS または管理設定の許可リストでそのホストを許可する必要があります。AnythingMCP Cloud から到達できるのは、HTTPS で公開インターネットに公開されているインスタンスのみです(たとえばリバースプロキシ経由や Home Assistant Cloud のリモートアクセス経由)。
プライバシー: 家庭のデータからは、誰が在宅しているかや世帯の日常の行動パターンが分かります。このコネクタは、そのデータの閲覧を許可されたユーザーの MCP サーバーにのみ割り当ててください。
時刻: タイムスタンプは、UTC の ISO 8601 形式で末尾に Z を付けて指定します。例: 2026-10-01T00:00:00Z。結果を表示する際は、home_assistant_get_config が返す自宅のタイムゾーンを使用します。
よくあるエラー: 401 はトークンが誤っているか削除されたことを意味します。1 つのエンティティまたはそのカレンダーイベントでの 404 は、その ID のエンティティが存在しないことを意味します。すべての呼び出しで 404 になる場合は、HOME_ASSISTANT_URL が誤っているか、すでに /api で終わっています。カレンダーイベントでの 400 は、start または end が欠けているか、有効なタイムスタンプではないことを意味します。接続が拒否またはブロックされた場合は、ホストが SSRF 許可リストで許可されていない(セルフホスト)か、HTTPS で公開されていない(Cloud)ことを意味します。
このコネクタは、アクションやサービスの呼び出し、状態の書き込みや削除、イベントの発火、テンプレートのレンダリング、カメラ画像の表示、イベントストリーム、エラーログ、WebSocket API(エリア、デバイス、エンティティレジストリ)の読み取りを行いません。
前提条件: HOME_ASSISTANT_URL、HOME_ASSISTANT_TOKEN
コネクタをローカルにインストールする
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/store を開き、Home Assistant を選んで、前提条件に記載した環境変数を貼り付けます。
利用可能なツール
| Tool | What it does |
|---|---|
home_assistant_get_config | Home Assistant の設定を取得します: バージョン、ロケーション名、タイムゾーン、単位系、座標、読み込み済みコンポーネント |
home_assistant_list_states | トークンで読み取れるすべてのエンティティを、entity_id、状態、フレンドリー名、単位、last_changed に絞って一覧表示します |
home_assistant_get_state | 1 つのエンティティの現在の状態を、すべての属性、last_changed、last_updated とともに取得します(例: サーモスタットの目標温度など…) |
home_assistant_get_history | 1 つ以上のエンティティについて、ある期間に記録された状態変化を取得します(例: 一晩のリビングの温度) |
home_assistant_get_logbook | 開始時刻以降のログブックエントリを取得します: ドアが開いた、照明が点いた、人が帰宅したといった人間が読める形式のイベント、さらに… |
home_assistant_list_calendars | この Home Assistant インスタンスのカレンダーエンティティを一覧表示します(entity_id と名前、例: calendar.family) |
home_assistant_get_calendar_events | 1 つのカレンダーの、開始から終了までのイベントを取得します: 概要、開始、終了、説明、場所 |
次のステップ
このガイドは役に立ちましたか?