Homemcpbridge MCP Server

Native macOS HomeKit integration for AI assistants via the Model Context Protocol (MCP).

Local serverstdioGo

What is the Homemcpbridge MCP server?

If you already use Homemcpbridge, the homemcpbridge mcp server is the piece that lets your assistant work with it directly. Native macOS HomeKit integration for AI assistants via the Model Context Protocol (MCP).

What the server does

HomeMCPBridge is a macOS app that lets AI assistants (Claude, and others that support MCP) control your HomeKit devices directly. Ask your AI to "turn off the living room lights" or "set the bedroom to 50% brightness" and it just works.

  • Native HomeKit — - Direct access to Apple's HomeKit framework, no bridges or hacks
  • MCP Protocol — - Works with Claude Code, Claude Desktop, and any MCP-compatible AI
  • All Device Types — - Lights, switches, outlets, fans, locks, garage doors, thermostats
  • Full Control — - On/off, brightness, color (hue/saturation), lock/unlock, open/close
  • Menu Bar App — - Runs quietly in the background with a status window
  • Plugin System — - Extend with Govee, Scrypted NVR, and more

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Cameras — The Cameras tool exposed by this server
  • Status — Overview of your smart home setup: - Apple HomeKit device count - Plugin status and device counts - Device link count - App settings (menu bar, dock
  • Devices — Browse all devices organized by room: - Tap (i) to link/unlink devices - Shows device source (HomeKit, Govee, etc.) - Indicates linked devices
  • Plugins — Configure third-party integrations: - Govee - Smart lights and appliances - Scrypted NVR - Network video recorder cameras
  • MCPPost — Broadcast real-time sensor events to your AI: - Configure webhook endpoint URL - Enable/disable event broadcasting - View recent events and their
  • Setup — Complete setup guide with: - MCP configuration snippets - Plugin setup instructions (Govee, Scrypted) - MCPPost configuration - Device linking guide
  • Configuration — 1. Open HomeMCPBridge 2. Go to the MCPPost tab 3. Enter your endpoint URL (e.g., http://localhost:8000/api/events) 4. Enable broadcasting with

Credentials and setup notes

  • macOS 14.0 (Sonoma) or later - HomeKit-enabled devices configured in the Apple Home app - An MCP-compatible AI assistant (Claude Code, Claude Desktop, etc.)

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Where it fits

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Homemcpbridge's toolset — Cameras, Status, Devices and 4 more — is a fair guide to whether it matches your workflow. It is maintained by rodaddy; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
CamerasThe Cameras tool exposed by this server.
StatusOverview of your smart home setup: - Apple HomeKit device count - Plugin status and device counts - Device link count - App settings (menu bar, dock icon)
DevicesBrowse all devices organized by room: - Tap (i) to link/unlink devices - Shows device source (HomeKit, Govee, etc.) - Indicates linked devices
PluginsConfigure third-party integrations: - Govee - Smart lights and appliances - Scrypted NVR - Network video recorder cameras
MCPPostBroadcast real-time sensor events to your AI: - Configure webhook endpoint URL - Enable/disable event broadcasting - View recent events and their status - Test endpoint connectivity
SetupComplete setup guide with: - MCP configuration snippets - Plugin setup instructions (Govee, Scrypted) - MCPPost configuration - Device linking guide
Configuration1. Open HomeMCPBridge 2. Go to the **MCPPost** tab 3. Enter your endpoint URL (e.g., http://localhost:8000/api/events) 4. Enable broadcasting with the toggle 5. Click "Test Endpoint" to verify

How to install the Homemcpbridge MCP server

{
  "mcpServers": {
    "homekit": {
      "command": "/Applications/HomeMCPBridge.app/Contents/MacOS/HomeMCPBridge",
      "args": []
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • macOS 14.0 (Sonoma) or later - HomeKit-enabled devices configured in the Apple Home app - An MCP-compatible AI assistant (Claude Code, Claude Desktop, etc.)

Example prompts to try

  • Use Homemcpbridge to Cameras.
  • Use Homemcpbridge to Status.
  • Use Homemcpbridge to Devices.

Frequently asked questions

It connects Homemcpbridge to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (Cameras, Status, Devices, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Homemcpbridge directly.