Hubitat MCP Server
Workato MCP Server for Hubitat Maker API
Ask AI about Hubitat MCP Server
Powered by Claude ยท Grounded in docs
I know everything about Hubitat MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Hubitat Maker API - OpenAPI Specification
An OpenAPI 3.0 specification for the Hubitat Maker API, designed for easy integration with Workato MCP servers, API gateways, and other tools that support OpenAPI/Swagger specifications.
Overview
The Hubitat Maker API provides a simple HTTP interface to control and monitor smart home devices connected to your Hubitat Elevation hub. This OpenAPI specification documents all available endpoints, making it easy to:
- Import into Workato to create MCP servers for AI agents (Claude, ChatGPT, Cursor)
- Generate API clients in any language
- Create interactive API documentation
- Build integrations with other platforms
Features
This specification covers all Hubitat Maker API functionality:
| Category | Endpoints | Description |
|---|---|---|
| Devices | /devices, /devices/all, /devices/{id} | List and query device information |
| Device Commands | /devices/{id}/{command} | Send commands like on, off, setLevel, setColor |
| Device Events | /devices/{id}/events | Retrieve device event history |
| Hub Variables | /hubvariables | Read and write hub variables |
| Modes | /modes | View and change hub modes (Home, Away, Night) |
| HSM | /hsm | Control Hubitat Safety Monitor arm states |
| Events | /postURL | Configure webhook for real-time event streaming |
Quick Start
Prerequisites
- A Hubitat Elevation hub
- Maker API app installed and configured on your hub
- Access token from your Maker API instance
- A Workato account (free Developer Sandbox available)
Getting a Free Workato Developer Sandbox Account
Workato offers a free Developer Sandbox that provides full access to their platform, including MCP server capabilities. Here's how to get started:
-
Sign up at workato.com/sandbox
- No credit card required
- Instant access after signup
-
What's included:
- Full access to Workato ONE platform
- 100,000 free usage events (approximately $1,000 value)
- 1,200+ pre-built connectors
- MCP server creation and hosting
- API Platform access
- AI-native capabilities (AIRO copilots, intelligent document processing)
- Enterprise-grade security (SAML 2.0, encryption, audit logs)
-
Usage limits:
- No time limit โ access continues until you reach your usage limit
- When limit is reached, recipes pause but you retain access
- Option to upgrade plans if needed
-
Supported regions:
- US, EU, AU, and SG data centers
- MCP servers hosted in US, EU, and APAC regions
๐ก Tip: The Developer Sandbox is a permanent developer environment, not a time-limited trial. It's designed for experimentation and building real integrations.
Getting Your Maker API Credentials
- Log into your Hubitat hub's admin interface
- Go to Apps โ Add Built-In App โ Maker API
- Select the devices you want to expose
- Note your App ID and Access Token from the generated URLs
Your API URL format will be:
http://[HUB_IP]/apps/api/[APP_ID]/[endpoint]?access_token=[ACCESS_TOKEN]
Usage with Workato MCP
Creating an MCP Server in Workato
โ ๏ธ Important: You must enable Cloud Access in your Hubitat Maker API settings and use the cloud URL. Workato's servers cannot reach your local hub IP directly.
Step 1: Enable Cloud Access in Hubitat
- Log into your Hubitat hub's admin interface
- Go to Apps โ Maker API
- Scroll down and enable Allow access via cloud endpoints
- Click Done to save
- Note your Cloud API URL โ it will look like:
https://cloud.hubitat.com/api/YOUR_CLOUD_ID/apps/APP_ID
Step 2: Create a Project in Workato
- Log into your Workato account
- Click Projects in the sidebar
- Click Create โ Project
- Enter a name (e.g., "Hubitat Smart Home")
- Click Create project
Step 3: Create an HTTP Connection
- Inside your project, click Create โ Connection
- Search for and select HTTP
- Configure the connection:
- Connection name: Hubitat Maker API
- Base URL: Your Maker API cloud URL:
https://cloud.hubitat.com/api/YOUR_CLOUD_ID/apps/APP_ID - Authentication type: Query params
- Query parameters:
- Key:
access_token - Value: Your Maker API access token
- Key:
- Click Connect to test and save
Step 4: Create an API Proxy Collection
- Navigate to Platform โ API Platform โ API Collections
- Click Create new API collection
- Select API proxy collection
- Configure the collection:
- Name: Hubitat Maker API
- Version: v1
- Project: Select your Hubitat project
- Select Import OpenAPI Specification
- Upload
hubitat-maker-api.yaml - Select the endpoints you want to expose
- For HTTP Connection, select the Hubitat connection you created in Step 3
- Click Create
- After creation, go to the Endpoints tab
- For each endpoint you want to use, click the three-dot menu (โฎ) and select Activate (or use the toggle to enable them)
๐ก Tip: You can activate all endpoints or just the ones you need. Inactive endpoints won't be available to the MCP server.
Step 5: Create the MCP Server
- Go to AI Hub โ MCP Servers
- Click Create MCP server
- Name: Hubitat Smart Home (or your preferred name)
- Select tools: Choose the Hubitat API collection you created
- Click Create MCP server
- On the MCP server page, click the Settings tab
- Under Access Method, ensure Token-based access is selected
- Under Developer MCP Token, click Copy to copy the full URL with token
- The URL will look like:
https://406.apim.mcp.trial.workato.com/username/hubitat-maker-api-v1?wkt_token=...
- The URL will look like:
๐ก Tip: You can also find the Remote MCP URL (without token) on the Overview tab in the right sidebar.
Example: Using with Claude
Once your MCP server is configured, you can use natural language commands like:
- "Turn on the living room lights"
- "Set the bedroom thermostat to 72 degrees"
- "What's the status of all my devices?"
- "Lock all the doors"
- "Set the house to Away mode"
Connecting to AI Assistants
After creating your MCP server in Workato, you can connect it to various AI assistants. You'll need your MCP URL and token from Workato:
- Go to AI Hub โ MCP Servers
- Click on your Hubitat MCP server
- Go to Settings โ End user access
- Copy the Developer MCP Token URL (includes the
wkt_token)
Claude (claude.ai)
- Open Claude and go to Settings โ Connectors
- Click + Add new connector
- Enter a name for your connector (e.g., "Hubitat Smart Home")
- Paste your MCP URL and token into the Remote MCP server URL field:
https://XXX.apim.mcp.workato.com/your-username/hubitat-maker-api-v1?wkt_token=YOUR_TOKEN - Click Add
- Click Configure on the newly created connector
- Set permissions to Always ask permission (recommended) or Allow unsupervised
- Start a new chat to use your Hubitat tools
ChatGPT (OpenAI)
- Open ChatGPT and go to Settings โ Apps & Connectors
- Enable Developer mode under Advanced settings
- Go back to Apps & Connectors and click Create
- Enter a name for your MCP connector (e.g., "Hubitat Smart Home")
- Paste your MCP URL and token in the URL field:
https://XXX.apim.mcp.workato.com/your-username/hubitat-maker-api-v1?wkt_token=YOUR_TOKEN - Optionally add a description
- Set Authentication to No Auth (authentication is handled via the token in the URL)
- Select the checkbox to accept the risk of adding a custom MCP server
- Click Create
- Start a new chat to use your Hubitat tools
Claude Desktop App
For the Claude desktop application, edit the configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Add your MCP server configuration:
{
"mcpServers": {
"hubitat": {
"url": "https://XXX.apim.mcp.workato.com/your-username/hubitat-maker-api-v1?wkt_token=YOUR_TOKEN"
}
}
}
Save the file and restart Claude Desktop.
Cursor IDE
- Go to Settings โ Cursor Settings
- Click MCP & Integrations in the sidebar
- Click + New MCP Server to open the
mcp.jsonfile - Add your configuration:
{
"mcpServers": {
"hubitat": {
"url": "https://XXX.apim.mcp.workato.com/your-username/hubitat-maker-api-v1?wkt_token=YOUR_TOKEN"
}
}
}
- Save and start a new chat with the Cursor agent
โ ๏ธ Important: You must start a new chat after adding an MCP server. AI assistants only detect MCP tools available when a chat begins.
API Endpoints Reference
Devices
| Method | Endpoint | Description |
|---|---|---|
| GET | /devices | List all authorized devices (basic info) |
| GET | /devices/all | List all devices with full details |
| GET | /devices/{deviceId} | Get specific device details |
| GET | /devices/{deviceId}/events | Get device event history |
| GET | /devices/{deviceId}/commands | List available commands for device |
| GET | /devices/{deviceId}/attribute/{name} | Get specific attribute value |
Device Commands
| Method | Endpoint | Example |
|---|---|---|
| GET | /devices/{id}/{command} | /devices/1/on |
| GET | /devices/{id}/{command}/{value} | /devices/1/setLevel/50 |
| GET | /devices/{id}/{command}/{v1}/{v2} | /devices/1/setLevel/50/2 |
Common Commands:
on/off- Switch controllock/unlock- Lock controlopen/close- Door/valve controlsetLevel/{0-100}- Dimmer levelsetColorTemperature/{2700-6500}- Color temperature in KelvinsetColor/{JSON}- Set color using HSB or hex valuessetThermostatSetpoint/{temp}- Thermostat controlrefresh- Refresh device state
Hub Variables
| Method | Endpoint | Description |
|---|---|---|
| GET | /hubvariables | List all hub variables |
| GET | /hubvariables/{name} | Get variable value |
| GET | /hubvariables/{name}/{value} | Set variable value |
Modes & HSM
| Method | Endpoint | Description |
|---|---|---|
| GET | /modes | List all modes and current mode |
| GET | /modes/{modeId} | Change to specified mode |
| GET | /hsm | Get HSM status |
| GET | /hsm/{armState} | Set HSM arm state |
HSM Arm States: armAway, armHome, armNight, disarm, disarmAll, cancelAlerts
Configuration
Server URLs
The specification includes two server configurations:
Local Access:
url: http://{hub_ip}/apps/api/{app_id}
Cloud Access:
url: https://cloud.hubitat.com/api/{cloud_id}/apps/{app_id}
Update the server variables with your specific values before importing.
Authentication
All endpoints require the access_token query parameter. In the OpenAPI spec, this is defined as:
securitySchemes:
accessToken:
type: apiKey
in: query
name: access_token
โ ๏ธ Security Note: Your access token is like a password. Anyone with this token can control your devices. Never share it publicly or commit it to version control.
File Structure
โโโ README.md
โโโ hubitat-maker-api.yaml # OpenAPI 3.0 specification
โโโ LICENSE
Contributing
Contributions are welcome! Please feel free to submit issues or pull requests for:
- Bug fixes in the specification
- Additional endpoint documentation
- Example integrations
- Improvements to descriptions
Resources
Hubitat
Workato
- Workato Developer Sandbox Signup
- Workato MCP Documentation
- Workato API Collections Guide
- Getting Started with MCP Servers
- Remote MCP Server Configuration
OpenAPI
License
MIT License - See LICENSE for details.
Disclaimer
This project is not affiliated with or endorsed by Hubitat, Inc. Hubitat and Hubitat Elevation are trademarks of Hubitat, Inc.
