@orellbuehler/homeassistant-mcp 0.3.0 → 0.4.0

package/README.md

@@ -120,15 +120,19 @@ available immediately. Verify with `claude mcp list` (should show `homeassistant
 
 **Registries** (WebSocket)
 
-| Tool                     | Description                                                                 |
-| ------------------------ | --------------------------------------------------------------------------- |
-| `list_registry_entities` | ALL registered entities, incl. disabled/unavailable (area, device, status). |
-| `list_devices`           | Devices (id, name, manufacturer, model, area).                              |
-| `list_areas`             | Areas (area_id, name, floor).                                               |
-| `list_labels`            | Labels (label_id, name, color, icon).                                       |
+| Tool                     | Description                                                                              |
+| ------------------------ | ---------------------------------------------------------------------------------------- |
+| `list_registry_entities` | ALL registered entities, incl. disabled/unavailable (area, device, status).              |
+| `rename_entity`          | Set an entity's registry `name` and/or `new_entity_id` (config edit, no device control). |
+| `list_devices`           | Devices (id, name, manufacturer, model, area).                                           |
+| `list_areas`             | Areas (area_id, name, floor).                                                            |
+| `list_labels`            | Labels (label_id, name, color, icon).                                                    |
 
 `list_entities` (REST) shows entities that currently have state; `list_registry_entities`
 (WebSocket) shows everything registered, including disabled entities, with area/device grouping.
+`rename_entity` writes the registry via `config/entity_registry/update` (requires an admin token):
+`name` overrides the friendly name (null reverts to the integration's `original_name`) and
+`new_entity_id` renames the entity_id within the same domain.
 
 **Energy dashboard** (WebSocket)
 

package/dist/server.js

@@ -9,7 +9,7 @@ import { registerRegistryTools } from "./tools/registry.js";
 import { registerEnergyTools } from "./tools/energy.js";
 import { registerTraceTools } from "./tools/trace.js";
 export function createServer(client, wsClient) {
-    const server = new McpServer({ name: "homeassistant-mcp", version: "0.3.0" });
+    const server = new McpServer({ name: "homeassistant-mcp", version: "0.4.0" });
     registerEntityTools(server, client);
     registerServiceTools(server, client);
     registerSystemTools(server, client);

package/dist/tools/registry.js

@@ -31,6 +31,38 @@ export function registerRegistryTools(server, ws) {
             return err(e);
         }
     });
+    server.tool("rename_entity", "Rename an entity in the entity registry via the WebSocket API (config/entity_registry/update). Set 'name' to override the friendly name (pass null to revert to the integration's original_name) and/or 'new_entity_id' to change the entity_id itself (must keep the same domain). At least one of name or new_entity_id is required. This edits registry config only — it does not control any device. Returns the updated entity_entry.", {
+        entity_id: z
+            .string()
+            .describe("Current entity_id to rename, e.g. 'cover.storen_wohnzimmer_links'"),
+        name: z
+            .string()
+            .nullable()
+            .optional()
+            .describe("New friendly name; null reverts to the integration's original_name"),
+        new_entity_id: z
+            .string()
+            .optional()
+            .describe("New entity_id; must keep the same domain, e.g. 'cover.wohnzimmer_links'"),
+    }, async ({ entity_id, name, new_entity_id }) => {
+        try {
+            if (name === undefined && new_entity_id === undefined) {
+                throw new Error("Provide at least one of 'name' or 'new_entity_id' to rename the entity");
+            }
+            if (new_entity_id !== undefined && domainOf(new_entity_id) !== domainOf(entity_id)) {
+                throw new Error(`new_entity_id must stay in the '${domainOf(entity_id)}' domain (got '${new_entity_id}')`);
+            }
+            const payload = { entity_id };
+            if (name !== undefined)
+                payload.name = name;
+            if (new_entity_id !== undefined)
+                payload.new_entity_id = new_entity_id;
+            return ok(await ws.command("config/entity_registry/update", payload));
+        }
+        catch (e) {
+            return err(e);
+        }
+    });
     server.tool("list_devices", "List devices from the device registry via the WebSocket API (id, name, manufacturer, model, area_id). Useful for grouping entities by physical device when writing automations.", {}, async () => {
         try {
             const list = (await ws.command("config/device_registry/list"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orellbuehler/homeassistant-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Model Context Protocol server for Home Assistant: introspect entities, services, events, registries, render templates and validate configuration to help AI agents author HA configs and automations.",
   "type": "module",
   "bin": {