added getCachedMatterAccessories() method

Author: bwp91

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to `@homebridge/plugin-ui-utils` will be documented in this file. This project tries to adhere to [Semantic Versioning](http://semver.org/).
 
+## v2.1.4 (Unreleased)
+
+### Changes
+
+- added `getCachedMatterAccessories()` method
+
 ## v2.1.3 (2026-02-08)
 
 ### Changes

README.md

@@ -186,6 +186,16 @@ Returns the cached accessories for the plugin.
 const cachedAccessories = await homebridge.getCachedAccessories()
 ```
 
+#### `homebridge.getCachedMatterAccessories`
+
+> `homebridge.getCachedMatterAccessories(): Promise<CachedMatterAccessory[]>;`
+
+Returns the cached Matter accessories for the plugin.
+
+```ts
+const cachedMatterAccessories = await homebridge.getCachedMatterAccessories()
+```
+
 ### Environment
 
 #### `homebridge.i18nCurrentLang`

src/ui.interface.ts

@@ -71,7 +71,21 @@ export interface CachedAccessory {
   services: any[]
 }
 
-export interface CachedMatterAccessory { /* coming soon */ }
+export interface CachedMatterAccessory {
+  plugin: string
+  platform: string
+  uuid: string
+  displayName: string
+  deviceType: {
+    name: string
+  }
+  serialNumber: string
+  manufacturer: string
+  model: string
+  clusters: Record<string, any>
+  $deviceId: string
+  $protocol: string
+}
 
 export declare type PluginConfig = Record<string, any>
 

src/ui.ts

@@ -248,7 +248,7 @@ class HomebridgePluginUi extends EventTargetConstructor {
   }
 
   public async getCachedMatterAccessories(): Promise<Record<string, any>[]> {
-    return []
+    return await this._requestResponse({ action: 'cachedMatterAccessories.get' })
   }
 
   public async request(path: string, body?: any) {