Skip to content

Add HomeKit tools through an embedded Mac Catalyst helper - #215

Open
mattt wants to merge 9 commits into
mainfrom
mattt/homekit-mcp-tools-plan
Open

mattt wants to merge 9 commits into
mainfrom
mattt/homekit-mcp-tools-plan

Conversation

@mattt

@mattt mattt commented Sep 16, 2026 •

Copy link
Copy Markdown
Owner
Screenshot 2026-09-16 at 05 28 26

The HomeKit framework isn't available to native macOS apps, so iMCP had no way to inspect or clean up a home's accessories, rooms, scenes, and automations. This adds a Home service backed by a Mac Catalyst helper, iMCP Helper, that a nested xcodebuild step embeds in iMCP.app; iMCP launches it on activation and forwards tool calls over a loopback MCP connection, with the tool definitions shared between both apps so the usual service and per-tool switches apply.

The tools cover inventory and a full export, identify, renames, batch room assignment, room and zone management, characteristic reads and writes, and scene and automation management, with the removal tools annotated as destructive. The README documents the helper's build, signing, and discovery.

The branch also lets imcp-server select a Bonjour service type through IMCP_SERVICE_TYPE, so the MCP Inspector can talk to the helper directly, and fixes task cancellation and closure captures in Capture and StdioProxy for Xcode 27.

@mattt
mattt force-pushed the mattt/homekit-mcp-tools-plan branch from a8eef6b to dd0a30a Compare September 20, 2026 16:12
@mattt
mattt marked this pull request as ready for review September 20, 2026 21:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant