Skip to content

Commit c2fd7f3

Browse files
GallaGithelpcodeai
andauthored
feat(adapters): read-only Home Assistant adapter (#1285)
* feat(adapters): add read-only Home Assistant adapter (#1237) Seven GET-only tools over the Home Assistant REST API: config, states, single state, history, logbook, calendars and calendar events. Bearer long-lived access token, user-supplied HOME_ASSISTANT_URL. Instructions cover the token, the SSRF allowlist on self-hosted, public HTTPS reachability on Cloud, UTC timestamps, a non-admin user and privacy. Regenerated catalog.ts via scripts/regenerate-catalog.mjs and bumped the quoted adapter count (547 -> 548). Adds a static + opt-in live spec and logo. * docs(guides): add Home Assistant to MCP guide (#1237) * test(home-assistant): live checks for all 7 tools and the healthcheck; note states size in guide * test(home-assistant): live check for the logbook entity filter --------- Co-authored-by: GallaGit <[email protected]> Co-authored-by: helpcode.ai <[email protected]>
1 parent 9fae38c commit c2fd7f3

13 files changed

Lines changed: 607 additions & 16 deletions

File tree

‎CITATION.cff‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ abstract: >
1313
server that turns REST/OpenAPI, SOAP/WSDL and GraphQL APIs, SQL/NoSQL
1414
databases and other MCP servers into tools for AI clients such as Claude,
1515
ChatGPT, Google Gemini, GitHub Copilot and Cursor, without writing code.
16-
It ships 547 pre-built adapters, with a focus on ERP and e-commerce
16+
It ships 548 pre-built adapters, with a focus on ERP and e-commerce
1717
systems (SAP Business One, Odoo, Xentral, JTL-Wawi, weclapp, Shopware,
1818
WooCommerce, Amazon Seller, Kaufland, OTTO, etc.), a per-workspace
1919
knowledge graph served over MCP, per-tool response mapping,

‎README.de.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<p align="center">
2-
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/badges/banner.de.png" alt="AnythingMCP macht ERP-, E-Commerce-, REST-, SOAP- und SQL-Systeme zu MCP-Tools für Claude und ChatGPT: 547 Connectors, 26 davon ohne API-Schlüssel." width="100%" />
2+
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/badges/banner.de.png" alt="AnythingMCP macht ERP-, E-Commerce-, REST-, SOAP- und SQL-Systeme zu MCP-Tools für Claude und ChatGPT: 548 Connectors, 26 davon ohne API-Schlüssel." width="100%" />
33
</p>
44

55
<h1 align="center">AnythingMCP: selbst gehostetes MCP-Gateway</h1>
@@ -19,7 +19,7 @@
1919

2020
<p align="center">
2121
<strong>AnythingMCP ist ein quelloffenes, selbst gehostetes MCP-Gateway, das jedes REST-/OpenAPI-, SOAP-, GraphQL-, OData- oder SQL-System in MCP-Tools für Claude, ChatGPT und Copilot verwandelt, ohne dass du einen MCP-Server programmierst.</strong><br/>
22-
Es bringt 547 fertige Adapter mit, darunter SAP, Etsy, weclapp und Amazon Seller; 26 davon kommen ohne API-Schlüssel aus.
22+
Es bringt 548 fertige Adapter mit, darunter SAP, Etsy, weclapp und Amazon Seller; 26 davon kommen ohne API-Schlüssel aus.
2323
</p>
2424

2525
<p align="center">
@@ -111,7 +111,7 @@ Tools werden zur Laufzeit registriert, ohne Neustart. `{{VAR}}`-Werte pro Connec
111111

112112
## Connector-Katalog
113113

114-
547 Adapter mit über 2.400 Tools. Zu jedem gibt es eine Einrichtungsanleitung auf [anythingmcp.com/de/guides](https://anythingmcp.com/de/guides), in sieben Sprachen.
114+
548 Adapter mit über 2.400 Tools. Zu jedem gibt es eine Einrichtungsanleitung auf [anythingmcp.com/de/guides](https://anythingmcp.com/de/guides), in sieben Sprachen.
115115

116116
| Kategorie | Beispiele |
117117
|---|---|

‎README.ja.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<p align="center">
2-
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/badges/banner.ja.png" alt="AnythingMCP は ERP、E コマース、REST、SOAP、SQL の各システムを Claude と ChatGPT 用の MCP ツールに変換します。547 のコネクター、うち 26 は API キー不要。" width="100%" />
2+
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/badges/banner.ja.png" alt="AnythingMCP は ERP、E コマース、REST、SOAP、SQL の各システムを Claude と ChatGPT 用の MCP ツールに変換します。548 のコネクター、うち 26 は API キー不要。" width="100%" />
33
</p>
44

55
<h1 align="center">AnythingMCP:セルフホスト型 MCP ゲートウェイ</h1>
@@ -19,7 +19,7 @@
1919

2020
<p align="center">
2121
<strong>AnythingMCP は、オープンソースのセルフホスト型 MCP ゲートウェイです。MCP サーバーを書かずに、REST/OpenAPI、SOAP、GraphQL、OData、SQL のあらゆるシステムを Claude、ChatGPT、Copilot 用の MCP ツールに変換します。</strong><br/>
22-
SAP、Etsy、weclapp、Amazon Seller などを含む 547 種類の既製アダプターを同梱しており、うち 26 は API キー不要です。
22+
SAP、Etsy、weclapp、Amazon Seller などを含む 548 種類の既製アダプターを同梱しており、うち 26 は API キー不要です。
2323
</p>
2424

2525
<p align="center">
@@ -111,7 +111,7 @@ amd64 ではイメージの取得に約 30 秒、その 24 秒後に API が利
111111

112112
## コネクターカタログ
113113

114-
547 個のアダプターで 2,400 以上のツールを提供しています。どのアダプターにも [anythingmcp.com/ja/guides](https://anythingmcp.com/ja/guides) に 7 言語の設定ガイドがあります。
114+
548 個のアダプターで 2,400 以上のツールを提供しています。どのアダプターにも [anythingmcp.com/ja/guides](https://anythingmcp.com/ja/guides) に 7 言語の設定ガイドがあります。
115115

116116
| カテゴリー | 例 |
117117
|---|---|

‎README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<p align="center">
2-
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/badges/banner.png" alt="AnythingMCP turns ERP, e-commerce, REST, SOAP and SQL systems into MCP tools for Claude and ChatGPT: 547 connectors, 25 of them with no API key." width="100%" />
2+
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/badges/banner.png" alt="AnythingMCP turns ERP, e-commerce, REST, SOAP and SQL systems into MCP tools for Claude and ChatGPT: 548 connectors, 25 of them with no API key." width="100%" />
33
</p>
44

55
<h1 align="center">AnythingMCP: self-hosted MCP gateway</h1>
@@ -19,7 +19,7 @@
1919

2020
<p align="center">
2121
<strong>AnythingMCP is an open-source, self-hosted MCP gateway that turns any REST/OpenAPI, SOAP, GraphQL, OData or SQL system into MCP tools for Claude, ChatGPT and Copilot, without writing an MCP server.</strong><br/>
22-
It ships 547 ready connectors, among them SAP, Etsy, weclapp and Amazon Seller, and 26 of them need no API key.
22+
It ships 548 ready connectors, among them SAP, Etsy, weclapp and Amazon Seller, and 26 of them need no API key.
2323
</p>
2424

2525
<p align="center">
@@ -103,7 +103,7 @@ Tools register at runtime, without a restart. Per-connector `{{VAR}}` values are
103103

104104
## Connector catalog
105105

106-
547 adapters, exposing 2,400+ tools. Every one has a setup guide on [anythingmcp.com/guides](https://anythingmcp.com/guides), in seven languages.
106+
548 adapters, exposing 2,400+ tools. Every one has a setup guide on [anythingmcp.com/guides](https://anythingmcp.com/guides), in seven languages.
107107

108108
| Category | Examples |
109109
|---|---|

‎README.zh-CN.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<p align="center">
2-
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/badges/banner.zh-CN.png" alt="AnythingMCP 将 ERP、电子商务、REST、SOAP 和 SQL 系统转化为 Claude 和 ChatGPT 可用的 MCP 工具:547 个连接器,其中 26 个无需 API 密钥。" width="100%" />
2+
<img src="https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/badges/banner.zh-CN.png" alt="AnythingMCP 将 ERP、电子商务、REST、SOAP 和 SQL 系统转化为 Claude 和 ChatGPT 可用的 MCP 工具:548 个连接器,其中 26 个无需 API 密钥。" width="100%" />
33
</p>
44

55
<h1 align="center">AnythingMCP:自行托管的 MCP 网关</h1>
@@ -19,7 +19,7 @@
1919

2020
<p align="center">
2121
<strong>AnythingMCP 是一个开源、可自行托管的 MCP 网关,无需编写 MCP 服务器,即可将任意 REST/OpenAPI、SOAP、GraphQL、OData 或 SQL 系统转化为 Claude、ChatGPT 和 Copilot 可用的 MCP 工具。</strong><br/>
22-
它自带 547 个现成适配器,涵盖 SAP、Etsy、weclapp 和 Amazon Seller 等,其中 26 个无需 API 密钥。
22+
它自带 548 个现成适配器,涵盖 SAP、Etsy、weclapp 和 Amazon Seller 等,其中 26 个无需 API 密钥。
2323
</p>
2424

2525
<p align="center">
@@ -111,7 +111,7 @@ docker compose up -d
111111

112112
## 连接器目录
113113

114-
共 547 个适配器,提供 2,400 多个工具。每个适配器都在 [anythingmcp.com/zh/guides](https://anythingmcp.com/zh/guides) 上提供七种语言的配置指南。
114+
共 548 个适配器,提供 2,400 多个工具。每个适配器都在 [anythingmcp.com/zh/guides](https://anythingmcp.com/zh/guides) 上提供七种语言的配置指南。
115115

116116
| 类别 | 示例 |
117117
|---|---|
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: "How to Connect Home Assistant to MCP for AI Agents"
3+
description: "Read Home Assistant entity states, history, logbook, and calendars with AI agents via MCP. Read-only: the adapter never controls devices."
4+
category: "connectors"
5+
keyword: "Home Assistant MCP Server, Home Assistant API AI, Home Assistant REST API MCP, connect Home Assistant to Claude, Home Assistant ChatGPT"
6+
publishedAt: "2026-10-26"
7+
adapterSlug: "home-assistant"
8+
---
9+
10+
## Home Assistant with AI Agents
11+
12+
Home Assistant is the most widely used open-source home automation platform, running on your own hardware. By connecting its REST API to AnythingMCP, AI agents can read the current state of every sensor, light, door, and thermostat, the recorded history, the logbook, and your calendars.
13+
14+
The adapter is **read-only**: every tool is a `GET` request. It cannot call actions (services), turn devices on or off, unlock doors, run scripts, or change states. Home Assistant's own action endpoint is not admin-only, so the read-only guarantee comes from the adapter exposing only `GET` requests, not from the token.
15+
16+
## Quick Setup
17+
18+
```bash
19+
git clone https://github.com/HelpCode-ai/anythingmcp.git
20+
cd anythingmcp && docker compose up -d
21+
```
22+
23+
1. In Home Assistant, create a dedicated **non-admin** user for AnythingMCP (**Settings > People > Users > Add user**, with Administrator switched off). None of the endpoints this adapter uses needs admin rights.
24+
2. Log in as that user, open your profile (your name at the bottom left), open the **Security** tab, and under **Long-lived access tokens** click **Create token**. Copy it: it is shown once, and Home Assistant makes these tokens valid for 10 years.
25+
3. Open `http://localhost:3000/connectors/store`, import the Home Assistant adapter, and configure:
26+
- `HOME_ASSISTANT_URL`: The address you open Home Assistant at, without a trailing slash and without `/api` (e.g., `https://home.example.com` or `http://192.168.1.10:8123`).
27+
- `HOME_ASSISTANT_TOKEN`: The long-lived access token, sent as `Authorization: Bearer <token>`.
28+
4. Check the setup with `home_assistant_get_config`.
29+
30+
```json
31+
{
32+
"mcpServers": {
33+
"home-assistant": { "url": "http://localhost:4000/mcp" }
34+
}
35+
}
36+
```
37+
38+
## Where Home Assistant Runs
39+
40+
- **Self-hosted AnythingMCP**: Home Assistant usually lives on a private network (`http://192.168.x.x:8123`, `homeassistant.local`). The outbound SSRF guard blocks private and local addresses by default, so an administrator must allow the host through the `SSRF_ALLOWED_HOSTS` environment variable or the allowlist in the admin settings.
41+
- **AnythingMCP Cloud**: Cloud can only reach a Home Assistant instance exposed on the public internet over HTTPS, for example behind a reverse proxy. Private IPs and local hostnames are refused, and the allowlist cannot be changed on Cloud.
42+
43+
## Available Tools
44+
45+
| Tool | Description |
46+
|------|-------------|
47+
| `home_assistant_get_config` | Version, location name, time zone, unit system, and loaded components (`GET /api/config`) |
48+
| `home_assistant_list_states` | Compact list of every entity: entity_id, state, name, unit, last change (`GET /api/states`) |
49+
| `home_assistant_get_state` | One entity with all its attributes (`GET /api/states/{entity_id}`) |
50+
| `home_assistant_get_history` | Recorded state changes for one or more entities; `filter_entity_id` is required (`GET /api/history/period/{start_time}`) |
51+
| `home_assistant_get_logbook` | Human-readable events such as a door opening or a person arriving (`GET /api/logbook/{start_time}`) |
52+
| `home_assistant_list_calendars` | Calendar entities, e.g. `calendar.family` (`GET /api/calendars`) |
53+
| `home_assistant_get_calendar_events` | Events of one calendar; `start` and `end` are required (`GET /api/calendars/{entity_id}`) |
54+
55+
**Timestamps** are ISO 8601 in UTC with a `Z` suffix, e.g. `2026-10-01T00:00:00Z`. An offset such as `+02:00` puts a `+` into the URL, so convert to UTC first.
56+
57+
**Response size:** Home Assistant's raw `/api/states` is large (about 60 KB for the 123 entities of the built-in demo), so `home_assistant_list_states` keeps only five fields per entity (about 19 KB for the same demo). Use `home_assistant_get_state` when you need one entity's attributes.
58+
59+
## Privacy
60+
61+
Home data reveals who is at home and daily routines. Assign this connector only to MCP servers whose users may see this household's data.
62+
63+
## Use Cases
64+
65+
- **"What was the living room temperature overnight?"**
66+
- **"Which windows are open right now?"**
67+
- **"When did the garage door last open?"**
68+
- **"What's on the family calendar this week?"**

‎glama.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,5 +3,5 @@
33
"maintainers": [
44
"helpcodeai"
55
],
6-
"description": "Turn any REST/OpenAPI, SOAP/WSDL, GraphQL, OData or SQL API into MCP tools for Claude, ChatGPT and Copilot, no code. 547 pre-built adapters for ERP and e-commerce (SAP S/4HANA, SAP Business One, Odoo, Xentral, JTL-Wawi, weclapp, Shopware, WooCommerce, Amazon Seller, Kaufland, OTTO\u2026) and more. Self-hosted, knowledge graph, per-tool response mapping, OAuth2/RBAC/SSO/audit. Open source under AGPL-3.0."
6+
"description": "Turn any REST/OpenAPI, SOAP/WSDL, GraphQL, OData or SQL API into MCP tools for Claude, ChatGPT and Copilot, no code. 548 pre-built adapters for ERP and e-commerce (SAP S/4HANA, SAP Business One, Odoo, Xentral, JTL-Wawi, weclapp, Shopware, WooCommerce, Amazon Seller, Kaufland, OTTO\u2026) and more. Self-hosted, knowledge graph, per-tool response mapping, OAuth2/RBAC/SSO/audit. Open source under AGPL-3.0."
77
}

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "anythingmcp",
33
"version": "0.50.0",
4-
"description": "Turn any REST/OpenAPI, SOAP/WSDL, GraphQL, OData or SQL API into MCP tools for Claude, ChatGPT and Copilot, no code. 547 pre-built adapters for ERP, e-commerce and more (SAP S/4HANA, SAP Business One, Odoo, Xentral, JTL-Wawi, Shopware, WooCommerce, Amazon Seller). Self-hosted, open source (AGPL-3.0).",
4+
"description": "Turn any REST/OpenAPI, SOAP/WSDL, GraphQL, OData or SQL API into MCP tools for Claude, ChatGPT and Copilot, no code. 548 pre-built adapters for ERP, e-commerce and more (SAP S/4HANA, SAP Business One, Odoo, Xentral, JTL-Wawi, Shopware, WooCommerce, Amazon Seller). Self-hosted, open source (AGPL-3.0).",
55
"private": true,
66
"license": "AGPL-3.0-only",
77
"engines": {

‎packages/backend/src/adapters/catalog.ts‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -255,6 +255,7 @@ import * as helpScout from './intl/help-scout.json';
255255
import * as hetznerCloud from './intl/hetzner-cloud.json';
256256
import * as heygen from './intl/heygen.json';
257257
import * as higgsfield from './intl/higgsfield.json';
258+
import * as homeAssistant from './intl/home-assistant.json';
258259
import * as hubspot from './intl/hubspot.json';
259260
import * as huggingface from './intl/huggingface.json';
260261
import * as hunter from './intl/hunter.json';
@@ -1042,6 +1043,7 @@ const RAW_ADAPTERS: AdapterDefinition[] = [
10421043
hetznerCloud as unknown as AdapterDefinition,
10431044
heygen as unknown as AdapterDefinition,
10441045
higgsfield as unknown as AdapterDefinition,
1046+
homeAssistant as unknown as AdapterDefinition,
10451047
hubspot as unknown as AdapterDefinition,
10461048
huggingface as unknown as AdapterDefinition,
10471049
hunter as unknown as AdapterDefinition,

0 commit comments

Comments
 (0)