# Homebridge

Connects Homebridge to your coding agent to adjust smart home accessories, edit configs, inspect logs, and manage plugins.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12 repo stars
- Author: mp-consulting
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mp-consulting/homebridge-ai-kit
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/homebridge

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `HOMEBRIDGE_URL`, `HOMEBRIDGE_TOKEN`, `HOMEBRIDGE_USERNAME`, `HOMEBRIDGE_PASSWORD`, `HOMEBRIDGE_READ_ONLY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-kit
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-kit
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-kit
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [mcp-hass](https://affpapa.org/en/nevibecode/skills/mcp-hass.md) — skill · 3200 installs
- [homeassistant-mcp-server](https://affpapa.org/en/nevibecode/skills/homeassistant-mcp-server.md) — skill · 207 installs
- [Tapo MCP](https://affpapa.org/en/nevibecode/mcp/tapo-mcp.md) — MCP server · ★ 877 repo stars
- [wemo](https://affpapa.org/en/nevibecode/mcp/wemo.md) — MCP server · ★ 56 repo stars
- [Yeelight IoT MCP Server](https://affpapa.org/en/nevibecode/mcp/yeelight-iot-mcp-server.md) — MCP server · ★ 10 repo stars
- [ccu-mcp](https://affpapa.org/en/nevibecode/mcp/ccu-mcp.md) — MCP server · ★ 9 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
