Heiman Smart Home MCP Server
OfficialThis server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Heiman Smart Home MCP Server
Use an AI assistant to query and control Heiman smart home devices in natural language — lights, air conditioning, curtains, temperature and humidity, device logs, rooms, scenes and security — through one remote MCP endpoint.
Endpoint |
|
Transport | MCP Streamable HTTP |
Authorization | OAuth 2.1 with PKCE (sign in with your smart home account) |
Repository |
|
Support |
|
This is a third-party integration, not an official Heiman / WorkBuddy / CodeBuddy / Anthropic / OpenAI / Microsoft product. Ownership and licensing boundaries are in NOTICE and OPEN-SOURCE-STATEMENT.md.
What you can do
Capability | Example request |
Device status and control | "Set the living room light brightness to 50%" |
Climate and sensors | "What is the current temperature and humidity in the living room?" |
Appliances | "Turn on the living room AC and set it to 26 degrees" |
Scenes | "Close the curtains and run the Home scene" |
History and aggregates | "Show the average temperature and humidity of the last 24 hours" |
Automations | "Create an automation that turns off the living room light every day at 11 pm" |
Security | Arm / disarm, alarm acknowledgement, alarm logs |
The full tool list, parameters and dialogue examples are in skills/heimanhome-skill/SKILL.md.
Related MCP server: Homey MCP Server
1. Connect and authorize
Add
https://spmcp.heimanhome.com/mcpto your MCP client using one of the configurations below.Your client opens the authorization page. Sign in with your smart home account.
Review the requested scopes. Read-only access is granted by default; tick write scopes only when you intend to control devices.
Approve. The client stores the token; your upstream credentials never enter this repository.
Authorization uses OAuth 2.1 with PKCE. Client ID Metadata Documents, pre-registered clients and dynamic client registration are all accepted, so most MCP clients work without extra setup.
2. Client configuration
Generic mcp.json
Claude Desktop, Cursor, Cline, Windsurf, Zed, VS Code + GitHub Copilot and MCP Inspector:
{
"mcpServers": {
"heiman-smart-home": {
"type": "streamableHttp",
"url": "https://spmcp.heimanhome.com/mcp",
"timeout": 30000
}
}
}Claude Code
claude mcp add --transport http heiman-smart-home https://spmcp.heimanhome.com/mcpClients that only support stdio
Bridge to the remote endpoint with mcp-remote:
{
"mcpServers": {
"heiman-smart-home": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://spmcp.heimanhome.com/mcp"]
}
}
}Hosted clients
ChatGPT connectors / apps, Claude.ai connectors, Copilot Studio, the OpenAI Responses API mcp tool, Gemini CLI and the WorkBuddy / CodeBuddy Connector marketplace: register a new remote MCP server in the client's own UI and paste the same URL. No file from this repository is required for that registration.
3. Scopes and safe writes
Scope | Allows |
| Device lists, status, capabilities, firmware, logs, sensor readings |
| Switching devices on/off, brightness, target temperature, curtains |
| Scenes, rooms, homes, automation listings |
| Running, creating, updating and deleting scenes / automations |
| Arm / disarm, alarm acknowledgement |
Without an explicit scope request the server grants read-only access.
High-impact actions require
confirm=true; preview them first withdry_run=true.When retrying a control command, pass
idempotent_key, then checkget_command_status(trace_id). A successful response means the command was accepted, not necessarily executed by the device.whoamishows the current identity and granted scopes.If a call is refused, fix the scope / parameter / confirmation instead of retrying the identical call.
4. Example prompts
Set the living room light brightness to 50%
What is the current temperature and humidity in the living room?
Turn on the living room AC and set it to 26 degrees
Close the curtains and run the Home scene
Show the average temperature and humidity of the last 24 hours
Create an automation that turns off the living room light every day at 11 pm
When the temperature is above 28 degrees, turn on the AC and set it to 26 degreesThe assistant answers in the language you use. Example utterances in 8 languages are in connector-meta.json → i18n.locales.
5. Troubleshooting
Symptom | What to do |
| Reconnect and authorize again in the client |
"scope not granted" | Re-authorize and tick the required scope on the consent page |
Command accepted but device unchanged | Check |
Too many requests | Wait before retrying; do not loop on the identical call |
Cannot connect | Confirm the client supports Streamable HTTP + OAuth and the endpoint is reachable over HTTPS |
6. Privacy and safety
Device control changes the physical world. Review
dry_runpreviews, keep write scopes to the minimum and use two-step confirmation.Access tokens and upstream credentials stay on the server. Never paste tokens, passwords or verification codes into public issues; report security issues to
help@heimanhome.com.The operator of the remote service is the data controller for home and device data — see
OPEN-SOURCE-STATEMENT.md.
Documentation languages
Language | Document |
English (authoritative) | |
Deutsch | |
Français | |
Español | |
Português | |
العربية (RTL) | |
Русский | |
简体中文 |
English is authoritative; translations are convenience copies. Arabic is right-to-left, while code blocks, tool names and JSON stay LTR.
License
MIT — see LICENSE. Ownership and trademark boundaries: NOTICE. Full statement: OPEN-SOURCE-STATEMENT.md.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to control Apple HomeKit smart home accessories, scenes, and automations via MCP tools.193MIT
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to control and query smart home devices through Homey Pro via an HTTP-based MCP server.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control Apple Home devices, scenes, and automations through MCP.12 npm39MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Home Assistant via natural language, including device control, automation management, and system monitoring.MIT