Homebridge — Claude Code MCP server: what it does, how to install
Connects Homebridge to your coding agent to adjust smart home accessories, edit configs, inspect logs, and manage plugins.
no license ★ 12 updated 2026-10-24
claude mcp add --env HOMEBRIDGE_URL=<HOMEBRIDGE_URL> --env HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> --env HOMEBRIDGE_USERNAME=<HOMEBRIDGE_USERNAME> --env HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> --env HOMEBRIDGE_READ_ONLY=<HOMEBRIDGE_READ_ONLY> --transport stdio homebridge -- npx -y @mp-consulting/homebridge-ai-kitWhat Homebridge does
This package provides 43 tools to query and operate Homebridge over stdio or HTTP. Your assistant can check system status, restart child bridges, install community plugins, and run regex searches across console logs.
Critical operations include safety checks. Commands targeting door locks or garage doors require explicit confirmation. Mass state adjustments and config updates support a dryRun mode before saving changes.
Running the server requires Homebridge 1.8+ or 2.x alongside valid network credentials. Pass HOMEBRIDGE_URL with a token or user credentials in your client configuration. Use HOMEBRIDGE_READ_ONLY when write access must be blocked.
What it helps with
- filter Homebridge runtime logs for recurring errors
- patch configuration safely with redacted credentials
- restart unresponsive child bridges
- manage scenes and accessories by room
Example prompts for the agent
- Run diagnose-logs on my Homebridge instance to catch recent crashes
- Inspect child bridge health and restart any failed processes
- Test a dryRun update to config.json before applying changes
How to install Homebridge
Platform CLI
claude mcp add --env HOMEBRIDGE_URL=<HOMEBRIDGE_URL> --env HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> --env HOMEBRIDGE_USERNAME=<HOMEBRIDGE_USERNAME> --env HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> --env HOMEBRIDGE_READ_ONLY=<HOMEBRIDGE_READ_ONLY> --transport stdio homebridge -- npx -y @mp-consulting/homebridge-ai-kitReplace <…> with your own values
Platform CLI
codex mcp add homebridge --env HOMEBRIDGE_URL=<HOMEBRIDGE_URL> --env HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> --env HOMEBRIDGE_USERNAME=<HOMEBRIDGE_USERNAME> --env HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> --env HOMEBRIDGE_READ_ONLY=<HOMEBRIDGE_READ_ONLY> -- npx -y @mp-consulting/homebridge-ai-kitReplace <…> with your own values
Config file
{
"mcpServers": {
"homebridge": {
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_USERNAME": "<HOMEBRIDGE_USERNAME>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>",
"HOMEBRIDGE_READ_ONLY": "<HOMEBRIDGE_READ_ONLY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"homebridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_USERNAME": "<HOMEBRIDGE_USERNAME>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>",
"HOMEBRIDGE_READ_ONLY": "<HOMEBRIDGE_READ_ONLY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e HOMEBRIDGE_URL=<HOMEBRIDGE_URL> -e HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> -e HOMEBRIDGE_USERNAME=<HOMEBRIDGE_USERNAME> -e HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> -e HOMEBRIDGE_READ_ONLY=<HOMEBRIDGE_READ_ONLY> homebridge npx -y @mp-consulting/homebridge-ai-kitReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Homebridge
How do I install Homebridge in Claude Code?
Run `claude mcp add homebridge-ai-kit -e HOMEBRIDGE_URL=<HOMEBRIDGE_URL> -e HOMEBRIDGE_TOKEN=<HOMEBRIDGE_TOKEN> -e HOMEBRIDGE_PASSWORD=<HOMEBRIDGE_PASSWORD> -- npx -y @mp-consulting/homebridge-ai-kit`. Supply your actual instance URL and authentication credentials in the placeholders.
What does this MCP server do?
It exposes Homebridge accessories, plugin lifecycle tools, and diagnostic logs to AI clients. Assistants can inspect setup details or adjust devices directly.
Does the server protect credentials and sensitive hardware?
Yes, sensitive tokens in config files are redacted before passing to the model. Hardware like door locks also requires manual confirmation.