Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What 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-kit

Replace <…> 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.

Similar MCP servers

All MCP servers for Automation and no-code: n8n, Zapier, Make →

Project sponsors

Companies that keep this analytics open