Hubitat-local

Hubitat-local MCP Server is a native MCP implementation that runs directly on a Hubitat Elevation hub, exposing a rich set of MCP tools (69 total) to AI clients. It enables natural-language style instructions and automated rule creation by interfacing with your Hubitat devices, rules, and system state. When connected through its Local Endpoint or Cloud Endpoint, you can query devices, read states, create automation rules, and manage rooms or hub administration tasks via MCP tools. The server exposes a core set of 21 tools publicly, with 48 additional tools behind nine domain-named gateways, giving you a large but organized tool surface for your AI clients.

To use it with Claude or another MCP consumer, configure an MCP client to point at the server’s endpoint URL (local or cloud). The client communicates over HTTP transport (Streamable HTTP), so ensure your client supports that transport. You can install and configure an Agent Skill for Claude to improve decision making, safety, and tool usage patterns when interacting with the hub.

Prerequisites:

• Hubitat Elevation hub (C-7, C-8, or C-8 Pro) with firmware 2.3.0+ for OAuth and internal API support
• Access to Hubitat web UI
• Optionally, Hubitat Package Manager (HPM) for easier installation

Installation steps (Option A: HPM, recommended):

1. Install Hubitat Package Manager (HPM) if you haven’t already, following the HPM installation instructions: https://hubitatpackagemanager.hubitatcommunity.com/installing
2. In HPM, go to Install, search for "MCP", and install the MCP Rule Server. HPM will install both the parent app and child app automatically and notify you of updates.
3. Alternatively, use the URL-based install via HPM: Install > From a URL and paste: https://raw.githubusercontent.com/kingpanther13/Hubitat-local-MCP-server/main/packageManifest.json

Installation steps (Option B: Manual):

1. Install the Parent App (MCP Rule Server):
   • Hubitat web UI > Apps Code > + New App
   • Import from URL: https://raw.githubusercontent.com/kingpanther13/Hubitat-local-MCP-server/main/hubitat-mcp-server.groovy
   • Import > OK > Save
   • OAuth > Enable OAuth in App > Save
2. Install the Child App (MCP Rule):
   • Apps Code > + New App > Import from URL: https://raw.githubusercontent.com/kingpanther13/Hubitat-local-MCP-server/main/hubitat-mcp-rule.groovy
   • Import > OK > Save
   • No OAuth needed for the child app

Quick Start guide:

• In Hubitat, open the MCP Rule Server app, select the devices you want accessible via MCP, then Save. Open the app to view endpoint URLs (Local and Cloud) and manage rules.
• Copy the Local Endpoint URL for local use: http://<LOCAL_IP>/apps/api/123/mcp?access_token=YOUR_TOKEN
• Copy the Cloud Endpoint URL for remote use (Hubitat Cloud subscription required): https://cloud.hubitat.com/apps/api/123/mcp?access_token=YOUR_TOKEN

Notes and tips:

• The Hubitat-local MCP server provides 69 tools in total; 21 core tools are always visible, with 48 behind 9 gateways to keep the interface manageable. If you’re building clients or automations, consider requesting gateway-based tool summaries first and fetch full parameter schemas on demand when needed.
• For remote access, you can use Hubitat Cloud or set up a Cloudflare Tunnel. Cloudflare Tunnel steps are described in the remote access section of the README; ensure your tunnel maps to your hub’s local HTTP endpoint.
• If you’re using Claude or Claude.ai (Connectors or Skills), you can add your hubitat MCP endpoint to the mcpServers section of your Claude config to connect seamlessly. The Optional Agent Skill can help Claude follow safety practices and better tool usage, especially for critical actions.
• Transport is Streamable HTTP. Ensure your MCP client supports HTTP transport; most modern MCP clients do by default.
• Keep OAuth tokens private and rotate them periodically for security.