プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Homey-Wan-Kenobi MCP

作者:Ringosystemsバージョン 2.2.0i★ 1iパソコンで動くリポジトリ ↗
レジストリ名io.github.Ringosystems/homey-wan-kenobi-mcp

インストール方法

What it does

MCP server for Homey Pro: 60 tools for devices, flows, energy, and Z-Wave/Zigbee diagnostics.

  • Connects パソコンで動く
  • Account or key Needs HOMEY_TOKEN · 1 setting to fill in (HOMEY_ADDRESS)
  • Category その他

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ3/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア7/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

チェック 3/3 合格 · あなたのパソコンで動きます

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

Homey-Wan-Kenobi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (HOMEY_ADDRESS) · 先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. Homey-Wan-Kenobi MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Homey-Wan-Kenobi MCP のサイトを開く ↗

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • HOMEY_ADDRESS Homey Pro ローカル API のベース URL。例:http://192.168.1.10
      英語の原文を見るBase URL of your Homey Pro local API, e.g. http://192.168.1.10

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  5. この設定を貼り付けて保存

    コマンドを確認中 · 確認が通るとコピーボタンが出ます

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

    Homey-Wan-Kenobi MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Homey-Wan-Kenobi MCP を使っていると言うか、回答に Homey-Wan-Kenobi MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Homey-Wan-Kenobi MCP につなげません

Homey-Wan-Kenobi MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Homey-Wan-Kenobi MCP につなげるアプリを使う

  • Homey-Wan-Kenobi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (HOMEY_ADDRESS) · 先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Homey-Wan-Kenobi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (HOMEY_ADDRESS) · 先にパソコンへ Docker を入れてください(1 回だけ)
  • Homey-Wan-Kenobi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (HOMEY_ADDRESS) · 先にパソコンへ Docker を入れてください(1 回だけ)
  • Homey-Wan-Kenobi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (HOMEY_ADDRESS) · 先にパソコンへ Docker を入れてください(1 回だけ)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

Homey-Wan-Kenobi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (HOMEY_ADDRESS) · 先にパソコンへ Docker を入れてください(1 回だけ)

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. Homey-Wan-Kenobi MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Homey-Wan-Kenobi MCP のサイトを開く ↗

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • HOMEY_ADDRESS Homey Pro ローカル API のベース URL。例:http://192.168.1.10
      英語の原文を見るBase URL of your Homey Pro local API, e.g. http://192.168.1.10

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  5. このコマンドを貼り付けて Enter

    コマンドを確認中 · 確認が通るとコピーボタンが出ます

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

    Homey-Wan-Kenobi MCP が一覧にあり、接続済みと表示されれば OK です

  7. 試してみる

    Homey-Wan-Kenobi MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Homey-Wan-Kenobi MCP を使っていると言うか、回答に Homey-Wan-Kenobi MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

Homey-Wan-Kenobi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (HOMEY_ADDRESS) · 先にパソコンへ Docker を入れてください(1 回だけ)

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. Homey-Wan-Kenobi MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Homey-Wan-Kenobi MCP のサイトを開く ↗

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • HOMEY_ADDRESS Homey Pro ローカル API のベース URL。例:http://192.168.1.10
      英語の原文を見るBase URL of your Homey Pro local API, e.g. http://192.168.1.10

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで Cursor を開く

    コマンドを確認中 · 確認が通るとコピーボタンが出ます

  5. キーを入力

    Homey-Wan-Kenobi MCP の設定で HOMEY_TOKEN, HOMEY_ADDRESS が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Cursor の AI チャットを Agent モードで開く

  7. 試してみる

    Homey-Wan-Kenobi MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Homey-Wan-Kenobi MCP を使っていると言うか、回答に Homey-Wan-Kenobi MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

Homey-Wan-Kenobi MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (HOMEY_ADDRESS) · 先にパソコンへ Docker を入れてください(1 回だけ)

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. Homey-Wan-Kenobi MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Homey-Wan-Kenobi MCP のサイトを開く ↗

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • HOMEY_ADDRESS Homey Pro ローカル API のベース URL。例:http://192.168.1.10
      英語の原文を見るBase URL of your Homey Pro local API, e.g. http://192.168.1.10

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで VS Code を開く

    コマンドを確認中 · 確認が通るとコピーボタンが出ます

  5. キーを入力

    Homey-Wan-Kenobi MCP の設定で HOMEY_TOKEN, HOMEY_ADDRESS が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. VS Code の AI チャットを Agent モードで開く

  7. 試してみる

    Homey-Wan-Kenobi MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Homey-Wan-Kenobi MCP を使っていると言うか、回答に Homey-Wan-Kenobi MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Homey-Wan-Kenobi MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

コマンドを確認中 · 確認が通るとコピーボタンが出ます

Claude Desktop (claude_desktop_config.json)

コマンドを確認中 · 確認が通るとコピーボタンが出ます

Cursor (~/.cursor/mcp.json)

コマンドを確認中 · 確認が通るとコピーボタンが出ます

VS Code (mcp.json)

コマンドを確認中 · 確認が通るとコピーボタンが出ます

自分で入力する値

  • HOMEY_ADDRESS 必須 env
    Homey Pro ローカル API のベース URL。例:http://192.168.1.10
    英語の原文を見るBase URL of your Homey Pro local API, e.g. http://192.168.1.10
  • HOMEY_TOKEN 秘密 必須 env
    Homey local API key (my.homey.app > Settings > API keys)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
2.2.0
カテゴリi
その他
レジストリ公開日i
2026年7月1日
コードの最終更新i
2026年7月1日
作者
Ringosystems
パッケージ
oci: docker.io/ringosystems/homey-wan-kenobi:2.2.0
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント Ringosystems で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:5 か月前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

未確認:バージョン付きの npm と PyPI パッケージのみ確認できます

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ringosystems-homey-wan-kenobi-mcp.svg)](https://mcp.popnx.com/en/servers/ringosystems-homey-wan-kenobi-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20693件のうち86%よりスターが多い
  • このカテゴリのほかの20693件のうち11%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20693件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Homey-Wan-Kenobi MCPは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:HOMEY_TOKEN

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は5 か月前、最新バージョン(2.2.0)がレジストリに届いたのは5 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582514 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51364 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Homey-Wan-Kenobi MCP
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/41/44/4
ライセンスMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Homey-Wan-Kenobi MCP

MCP server for controlling Homey Pro smart home systems through the Model Context Protocol.

The name nods to Obi-Wan Kenobi, your home's only hope for natural-language control.

60 tools and 3 knowledge prompts for device control, flow authoring, automation, monitoring, troubleshooting, network diagnostics, and self-hosted deployment.

Why Homey-Wan-Kenobi

Athom ships an official Homey MCP Server: a cloud-brokered remote connector you add to a paid Claude or ChatGPT plan and sign into with your Homey account. It covers device status and control, renaming and moving devices, creating, updating and starting Flows and Advanced Flows, and setting Moods.

This server differs in two ways. It is self-hosted, so you run it yourself over stdio or streamable-HTTP with no third-party broker and no paid AI-plan requirement. And it adds operational depth for power users that is not part of the official server's described capabilities.

The table reflects Athom's publicly described capabilities as of June 2026. Athom does not publish a formal tool list, so the right-hand gaps are inferred from their documentation, not stated by Athom.

CapabilityOfficial Homey MCP (mcp.athom.com)Homey-Wan-Kenobi
HostingCloud-brokered remote connectorSelf-hosted, stdio or HTTP, no broker
AccessPaid Claude/ChatGPT connector planAny MCP client, no plan requirement
Devices, zones, control, rename, moveYesYes
Flow and Advanced Flow authoringYesYes
MoodsYesYes
Flow-card schema discovery (build flows from scratch)Not describedYes
Energy: live power and day/week/month/year reportsNot describedYes
Insights: historical sensor and meter dataNot describedYes
Z-Wave and Zigbee mesh diagnostics with remediationsNot describedYes
App memory and usage analysis (removal candidates)Not describedYes
Infrastructure ops: backups, reboot, updates, memory, storageNot describedYes
Raw Homey Web API passthroughNot describedYes
Listed in the public MCP RegistryNoYes
The depth, in practice
  • Network diagnostics that the official server does not describe. diagnose_zwave_network and diagnose_zigbee_network read controller health, grade each node by last-seen age (battery-sleep aware), group transmit failures, correlate them with unavailable devices, and return severity-ranked remediations. get_zwave_log exposes the raw network log.
  • Energy and Insights analysis. Live power by zone and device, day/week/month/year energy reports, and timestamped historical sensor and meter data, so the model can answer "what is using power right now" or "how has the bedroom temperature trended this week".
  • App memory and usage analysis. analyze_app_usage cross-references every app against RAM, device counts and flow references to flag safe removal candidates and estimate savings. Read-only and advisory.
  • Build automations from scratch. A flow-card discovery engine (list_flow_cards, get_flow_card) returns each card's full argument schema, and full standard and Advanced Flow CRUD (including delete) lets an AI author and tear down the whole cards graph by UUID.
  • Infrastructure operations from one interface. Backups, reboot, update checks, memory and storage usage, drivers, LED ring, session and location info.
  • A future-proof escape hatch. homey_api_call reaches any Homey Web API endpoint directly, so new firmware features work without waiting for a tool update.

It runs on a hardened, non-root node:22-alpine image whose every build and release is gated on a Trivy scan, and it is published to Docker Hub, GHCR and the public MCP Registry. See the tool reference below for the full list.

When the official server is the better fit

This server is local-first and self-hosted, which is both its strength and its trade-off. The official Homey MCP is the easier choice when you want:

  • Zero setup and managed hosting. Add one URL and sign in with your Homey account. There is no container to run, expose, or maintain, and there is a one-click ChatGPT app.
  • Secure remote access from anywhere. Athom brokers the connection through its cloud, so it works away from home without exposing anything on your LAN. This server's HTTP mode is intended for a trusted local network; remote use is your own VPN or authenticated reverse proxy.
  • Every Homey model. The official endpoint reaches Homey Cloud, Pro, Pro mini and Self-Hosted Server, including cloud-only setups that have no local API. This server targets a Homey reachable over its local API or your Athom token, so it is happiest with a Homey Pro.
  • First-party support. It is maintained by Athom, kept in step with firmware, and officially tested with Claude and the ChatGPT app. This project is independent and best-effort.

The two are complementary. Many people use the official connector for quick remote control and this server for the deep local diagnostics, energy analysis, and infrastructure work. Athom does not publish a formal tool list, so the official server may also include capabilities not reflected above.

Quick Start

git clone https://github.com/Ringosystems/Homey-Wan-Kenobi-MCP.git

cd Homey-Wan-Kenobi-MCP npm install npm run build

Authenticate with your Homey:

npx homey login

npx homey select

Add to your MCP client config (Kiro, Claude Desktop, Cline, etc.):

{

"mcpServers": { "homey": { "command": "node", "args": ["/path/to/Homey-Wan-Kenobi-MCP/dist/index.js"] } } }

Authentication

The server supports two authentication methods:

Homey CLI (recommended) runs npx homey login and npx homey select. The server reads the stored OAuth token from ~/.athom-cli/settings.json automatically.

Local API Key is created at my.homey.app. Set environment variables:

export HOMEY_ADDRESS=http://192.168.1.x

export HOMEY_TOKEN=your-api-key

The local API key method is the recommended choice when running self-hosted in a container, since it does not depend on a mounted CLI settings file.

Self-Hosted (Docker / HTTP)

The image is published at ringosystems/homey-wan-kenobi (mirrored to ghcr.io/ringosystems/homey-wan-kenobi), and the server is listed in the MCP Registry as io.github.Ringosystems/homey-wan-kenobi-mcp. It is built on node:22-alpine, runs as a non-root user, and ships no baked-in secrets. See SECURITY.md for the audit details.

It defaults to the stdio transport so an MCP client can launch it directly, and exposes a long-lived streamable-HTTP service (via supergateway at /mcp, health at /healthz) when you set MCP_TRANSPORT=streamable-http.

Fastest: one command (prebuilt image)

No clone or build. Pull two things and start it:

curl -fsSLO https://raw.githubusercontent.com/Ringosystems/Homey-Wan-Kenobi-MCP/main/docker-compose.deploy.yml

printf 'HOMEY_ADDRESS=http://192.168.1.x\nHOMEY_TOKEN=your-local-api-key\n' > .env docker compose -f docker-compose.deploy.yml up -d

The service is then at http:// :8000/mcp (health at /healthz). On Unraid, add the template by URL instead: Docker, Add Container, paste https://raw.githubusercontent.com/Ringosystems/Homey-Wan-Kenobi-MCP/main/deploy/unraid/homey-wan-kenobi.xml into the Template field. The image is multi-arch, so it runs on x86 and ARM (Apple Silicon, Raspberry Pi) hosts.

The /mcp endpoint has no built-in authentication. Keep it on a trusted LAN or behind a reverse proxy that adds TLS and auth.

Run as an MCP client (stdio)
docker run -i --rm \

-e HOMEY_ADDRESS=http://192.168.1.x \ -e HOMEY_TOKEN=your-local-api-key \ ringosystems/homey-wan-kenobi:latest

Run as an HTTP service
docker run -d -p 8000:8000 \

-e MCP_TRANSPORT=streamable-http \ -e HOMEY_ADDRESS=http://192.168.1.x \ -e HOMEY_TOKEN=your-local-api-key \ --restart unless-stopped \ ringosystems/homey-wan-kenobi:latest

Docker Compose

Supply your Homey credentials via a .env file next to docker-compose.yml:

cat > .env <<'EOF'

HOMEY_ADDRESS=http://192.168.1.x HOMEY_TOKEN=your-local-api-key EOF

Pull the published image, or add --build to build locally instead

docker compose up -d

The provided docker-compose.yml references the published image (with build: . as a local-build fallback) and applies container hardening (read-only root filesystem, dropped Linux capabilities, no-new-privileges, and memory/PID limits):

services:

homey-wan-kenobi: image: ringosystems/homey-wan-kenobi:latest build: . container_name: homey-wan-kenobi ports:

  • "8000:8000" environment: MCP_TRANSPORT: streamable-http HOMEY_ADDRESS: "${HOMEY_ADDRESS:-http://192.168.1.x}" HOMEY_TOKEN: "${HOMEY_TOKEN:-}" restart: unless-stopped read_only: true tmpfs:
  • /tmp security_opt:
  • no-new-privileges:true cap_drop:
  • ALL mem_limit: 256m pids_limit: 128 healthcheck: test: ["CMD", "node", "-e", "fetch('http://localhost:8000/healthz').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"] interval: 30s timeout: 5s retries: 3 start_period: 20s
Build locally
docker build -t ringosystems/homey-wan-kenobi .

docker run -d -p 8000:8000 \ -e MCP_TRANSPORT=streamable-http \ -e HOMEY_ADDRESS=http://192.168.1.x \ -e HOMEY_TOKEN=your-local-api-key \ --restart unless-stopped \ ringosystems/homey-wan-kenobi

Connecting a client

Point an MCP client at the streamable-HTTP endpoint:

{

"mcpServers": { "homey": { "type": "streamable-http", "url": "http://your-host:8000/mcp" } } }

Check health with curl http://your-host:8000/healthz.

Tools

Devices
ToolDescription
list_devicesList devices with live capability values, filter by zone or class
get_deviceGet full device details and all capability values by ID
search_devicesSearch devices by name, class, or capability
set_device_capabilityControl a device (onoff, dim, target_temperature, volume_set, etc.)
Device & Zone Management
ToolDescription
rename_deviceRename a device
move_device_to_zoneMove a device to a different zone (room)
create_zoneCreate a new zone, optionally nested under a parent
Zones
ToolDescription
list_zonesList all zones (rooms/areas) with their hierarchy
Flows
ToolDescription
list_flowsList simple and advanced flows with enabled/broken status
trigger_flowRun a flow immediately
set_flow_enabledEnable or disable a flow
Flow Authoring
ToolDescription
get_flowGet a standard WHEN/AND/THEN flow definition by ID
create_flowCreate a standard flow from trigger/conditions/actions
update_flowUpdate fields of a standard flow

| delete_flow | Permanently delete a stan

冒頭だけを表示しています。続きはリポジトリで読めます