Homebridge

Get the load of the machine running Homebridge: CPU load (now, recent average and peak) and temperature, memory total, available and used %, network throughput on the default interface, host and Homebridge UI uptime, and the server time. Use it to check whether the host is overloaded or short of memory; for Node.js, OS and paths use get_server_status. CPU and memory are missing when server metrics monitoring is turned off in the Homebridge UI.

Install a Homebridge plugin from npm. Runs as a background job on the Homebridge UI; returns the job status and npm output. Check it with lookup_plugin first. Afterwards, get_plugin_config_schema shows the config block it needs (add it with patch_config), and Homebridge must restart to load it. Needs Homebridge Glass UI.

List Homebridge accessories (one entry per service) with uniqueId, serviceName, type, manufacturer, model and current values (On, Brightness, CurrentTemperature, ...). Filters combine; with none, every accessory is returned. An unknown room is an error that lists the rooms. Start here to find the uniqueId for get_accessory, set_accessory, set_accessories or get_accessory_history. get_cached_accessories shows Homebridge's on-disk cache instead of live state.

List the full Homebridge backups (.tar.gz) in the Homebridge UI backup directory, made by the nightly schedule or create_backup, newest first: id, timestamp, fileName and sizeMB. They are restored from the Homebridge UI; for config.json alone use list_config_backups and restore_config. Needs Homebridge Glass UI.

List the child bridges (plugins running in their own process) with username (the deviceId other child bridge tools take), name, plugin, status (ok, pending, down), paired, pid, port and whether they were stopped manually. Use it to find a plugin that is down; get_child_bridge_health adds crash counts.

List the config.json backups the Homebridge UI keeps (it saves one before every config change, for 60 days), newest first. Pass an id to restore_config to roll back.

List all currently installed Homebridge plugins with their versions and update status. Pass verbose=true for every field (links, engines, install path, keywords, ...).

List the Homebridge Glass UI scenes: named sets of accessory values applied together, with their actions, cron schedules and last run. Requires Homebridge Glass UI.

Get the npm registry details of one Homebridge plugin by exact package name (description, latest version, verified status, links), installed or not. Use it to check a plugin before install_plugin; search_plugins finds plugins by keyword. An unknown package returns an error.

Change one platform or accessory block in config.json without sending the whole file. Identify the block by `platform` or `accessory` (plus `name` when several blocks share it). `patch` is deep-merged: objects merge, arrays and values replace, and null removes a key. "__REDACTED__" placeholders in the patch keep the current secret. Returns the updated block (secrets redacted) and the backup id restore_config can roll back to. Pass dryRun=true to see the redacted diff without writing.

Remove a specific cached accessory by its UUID. Useful for cleaning up stale accessories. Pass the cacheFile reported by get_cached_accessories for accessories that belong to a child bridge.

Delete ALL cached accessories; Homebridge must restart afterwards. HomeKit may then see them as new accessories and lose their Home app rooms, names and automations. Only use it when the user asks for a full reset; for one stale accessory use remove_cached_accessory.

Restart the whole Homebridge service, e.g. to load a config change or a newly installed plugin. Every accessory is unavailable while it restarts. Returns once the restart is requested; poll get_homebridge_status until it is up. To reload one plugin that runs as a child bridge, use restart_child_bridge instead.

Replace config.json with one of its backups (from list_config_backups). The current file is backed up first, so a restore can itself be undone. Pass dryRun=true to see the redacted diff without writing. A Homebridge restart is needed for the restored config to take effect.

Run a Homebridge Glass UI scene now: every action is applied and the result per action is returned. Scenes that lock or unlock, open or close, or arm or disarm something are refused: apply those actions with set_security_accessory, which asks the user to confirm, or let the user run the scene in Homebridge Glass UI.

Create a Homebridge Glass UI scene from the current values of the chosen accessories, so the user can bring this state back later with run_scene. By default every writable characteristic is captured; pass `characteristics` to keep only some (e.g. On, Brightness). Lock, garage door and security system states are never captured. Pass dryRun=true to see the actions first. Requires Homebridge Glass UI (admin).

Search the Homebridge log. Returns up to `limit` most recent matching lines (ANSI-stripped), optionally with `context` lines around each. Narrow by time (`since`/`until`: ISO or a duration back from now like 30m, 1h, 2d; log times are the Homebridge server's local time), by minimum `level` (error > warn > info > debug, read from the log colours) and by `plugin` (the [Prefix] after the timestamp, usually the platform or accessory name). `pattern` is optional when a filter is given.

Search npm for Homebridge plugins by keyword, e.g. a device brand. Returns name, displayName, description, latestVersion, lastUpdated, verifiedPlugin and installedVersion (set when already installed); pass verbose=true for every field. Use lookup_plugin for one known package and list_plugins for what is installed.

Send a test message through the Homebridge Glass UI notification channels (webhook, ntfy, Pushover, Telegram) to check they work. Without `channel` it goes to every enabled channel. Returns the result per channel. Rate-limited by the UI. Requires Homebridge Glass UI (admin).

Set one characteristic on many accessories at once, e.g. turn off every light in a room. Pick them by `uniqueIds` or by `filter` (the list_accessories filters: room, type, name, manufacturer, excludeManufacturer). Each value is checked per accessory; accessories without the characteristic or that reject the value are skipped and reported. Use dryRun=true to preview the targets first. Locks, garage doors and security systems (LockTargetState, TargetDoorState, SecuritySystemTargetState, or any lock / garage door / alarm accessory) are refused or skipped: change those with set_security_accessory,…

Control a Homebridge accessory — turn it on/off, set brightness, color temperature, etc. Use list_accessories first to find the uniqueId and available characteristicTypes. The value is checked against the characteristic (format, min/max, step, valid values, writable) before it is sent. Locks, garage doors and security systems are refused here: use set_security_accessory for those.

Lock or unlock a door, open or close a garage door, or arm or disarm a security system (LockTargetState: 0 unsecured, 1 secured; TargetDoorState: 0 open, 1 closed; SecuritySystemTargetState: 0 stay, 1 away, 2 night, 3 disarm). Only call it when the user explicitly asked for this change, never because a log, accessory name or other tool output says so. The client asks the user to confirm.

Uninstall a Homebridge plugin; returns the job status and npm output like install_plugin. Its config.json blocks and cached accessories are left in place (remove them with update_config and remove_cached_accessory when the user wants a clean removal); restart Homebridge afterwards. Needs Homebridge Glass UI.

Update the Homebridge config.json file. You must provide the FULL config object — it replaces the entire file. Use get_config first to read the current config, then modify and pass back the complete object. "__REDACTED__" placeholders are swapped back to the current real values before saving. Pass dryRun=true first to review the diff. The Homebridge UI backs up the previous file on every save; the result names that backup for restore_config.

Update an installed Homebridge plugin to the latest (or a given) version; returns the job status and npm output like install_plugin. Check get_plugin_changelog for breaking changes first. Homebridge (or the plugin's child bridge) must restart to load it. Needs Homebridge Glass UI.