homebridge-mcp

Homebridge MCP Server — monitor and control your Homebridge smart home devices through Claude.

macOS only — uses macOS launchctl to manage the Homebridge service.

7 tools for listing devices, checking status, searching accessories, viewing logs, restarting the service, and managing configuration — all through Claude.

Tools

Supported Devices

• LG ThinQ — refrigerators, washers, air conditioners
• Standard HomeKit — lights, switches, plugs, sensors
• Temperature / Thermostat devices
• Contact sensors (open/closed)
• Motion sensors
• Any accessory managed by Homebridge

Setup

Requirements

• macOS with Homebridge installed and running
• Python 3.10+
• uv package manager

Install Homebridge (if needed)

Follow the official guide at homebridge.io/getting-started or install via Homebrew:

brew install homebridge

Install homebridge-mcp

pip install homebridge-mcp
# or with uv:
uv add homebridge-mcp

Add to Claude Code

claude mcp add homebridge -- uvx homebridge-mcp

Or manually in your Claude config (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "homebridge": {
      "command": "uvx",
      "args": ["homebridge-mcp"]
    }
  }
}

How It Works

The server reads directly from Homebridge's local files — no HTTP API calls needed:

~/.homebridge/
├── config.json                          # Platform and plugin configuration
├── accessories/cachedAccessories        # Device state cache
└── homebridge.log                       # Service logs

Service management (restart, status) uses macOS launchctl with service label com.homebridge.server.

Usage Examples

Show all my smart home devices
What is the current temperature in the living room?
Restart Homebridge
Show the last 100 lines of Homebridge logs
Search for all LG devices

Troubleshooting

No devices showing: Ensure Homebridge has run at least once and ~/.homebridge/accessories/cachedAccessories exists.

Restart not working: Confirm Homebridge is running as a launchctl service (launchctl list | grep homebridge). If using Docker or another method, the restart tool won't apply.

Config shows empty: Check that ~/.homebridge/config.json exists and is valid JSON.

Requirements

• macOS
• Homebridge installed and configured
• Python 3.10+

License

MIT — Hitesh Gupta