@mp-consulting/homebridge-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOMEBRIDGE_URL | Yes | URL of your Homebridge UI | |
| HOMEBRIDGE_PASSWORD | Yes | Homebridge UI login password | |
| HOMEBRIDGE_USERNAME | Yes | Homebridge UI login username |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_accessoriesB | List all Homebridge accessories with their current state (on/off, brightness, temperature, etc.) |
| get_accessoryA | Get detailed information about a specific accessory by its uniqueId. Use list_accessories first to find the uniqueId. |
| set_accessoryA | Control a Homebridge accessory — turn it on/off, set brightness, color temperature, etc. Use list_accessories first to find the uniqueId and available characteristicTypes. |
| get_accessory_layoutA | Get the accessories room layout as configured in the Homebridge UI. |
| get_homebridge_statusA | Check if Homebridge is running and get its current status (up/down, version, plugins status). |
| get_server_statusA | Get Homebridge server information including version, Node.js version, uptime, OS details, and Homebridge instance ID. |
| restart_homebridgeA | Restart the Homebridge service. This will temporarily make all accessories unavailable. |
| get_pairing_infoA | Get the HomeKit pairing information (setup code, QR code URL) for this Homebridge instance. |
| get_cached_accessoriesA | List all cached accessories stored by Homebridge. These persist across restarts. |
| remove_cached_accessoryA | Remove a specific cached accessory by its UUID. Useful for cleaning up stale accessories. |
| reset_cached_accessoriesA | Reset ALL cached accessories. WARNING: This removes all cached accessories and requires a Homebridge restart. |
| get_configA | Read the current Homebridge config.json file content. Returns the full configuration including bridge settings, accessories, and platforms. |
| update_configA | 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. |
| list_pluginsA | List all currently installed Homebridge plugins with their versions and update status. |
| search_pluginsB | Search the npm registry for Homebridge plugins matching a query. |
| lookup_pluginA | Get detailed information about a specific Homebridge plugin from the npm registry. |
| get_plugin_versionsA | Get available versions and dist-tags for a specific Homebridge plugin. |
| get_plugin_config_schemaA | Get the config.schema.json for a plugin, which describes how to configure it in Homebridge. |
| get_plugin_changelogB | Get the CHANGELOG.md content for an installed Homebridge plugin. |
| get_system_infoA | Get system information for the machine running Homebridge (CPU, memory, OS, network interfaces, uptime). |
| get_recent_logsA | Return the most recent lines from the Homebridge log (ANSI-stripped). Requires an hb-service based Homebridge install. |
| search_logsA | Search the Homebridge log for matching lines. Returns up to |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 22 tools
Each tool targets a distinct aspect of Homebridge management: accessories (list/get/set/layout/cached), server status, logs, config, plugins, and system info. Even similar-sounding tools like get_homebridge_status and get_server_status have clear differences in their descriptions—one focuses on health and plugin status, the other on version and instance details—so there is no ambiguity.
All tool names follow a consistent verb_noun pattern using snake_case: get_, set_, list_, search_, remove_, reset_, update_, restart_, lookup_. The same verbs are reused predictably across domains (e.g., get_accessory, get_cached_accessory, get_plugin_versions), which makes it easy to infer tool behavior from the name alone.
With 22 tools, the server is on the heavier side, but it covers a wide range of domains—accessory control, configuration, plugins, logs, status, and system info—all relevant to Homebridge. Each tool has a distinct role, and the count feels justified given the breadth of functionality, though it could be trimmed slightly without losing critical functionality.
The tool set is remarkably complete for the Homebridge domain: it covers accessory discovery and control, cached accessory management, config reading and writing, plugin discovery/search/details/versions/schema/changelog, log retrieval and search, server and system status, restart, and pairing info. There are no obvious dead ends—agents can perform full lifecycle operations on accessories, plugins, and configuration.