device state querying and control via mcp protocol
Exposes Homey device objects through the Model Context Protocol (MCP), allowing LLM agents to query device capabilities, read current state (on/off, brightness, temperature, etc.), and send control commands. Implements MCP's resource and tool abstractions to map Homey's REST API device endpoints into standardized LLM-callable operations, with automatic schema generation for device-specific capabilities.
Unique: Bridges Homey's proprietary REST API into MCP's standardized tool/resource model, enabling any MCP-compatible LLM to control Homey devices without custom integrations. Automatically generates tool schemas from Homey device capabilities rather than requiring manual tool definition.
vs alternatives: Unlike direct REST API wrappers, MCP abstraction allows the same Homey integration to work with Claude, Anthropic's SDK, and any future MCP-compatible model without code changes.
flow execution and automation triggering via mcp tools
Exposes Homey Flows (automation rules) as callable MCP tools, allowing LLM agents to trigger pre-configured automations by flow ID or name. Implements a tool registry that maps Homey flow objects to MCP tool definitions with parameters for flow arguments, enabling agents to orchestrate complex multi-step automations without directly controlling individual devices.
Unique: Treats Homey Flows as first-class MCP tools rather than just device commands, allowing agents to invoke high-level automations defined in Homey's visual editor. This abstraction layer lets non-technical users maintain automation logic while AI agents execute it.
vs alternatives: More flexible than direct device control because flows can encode complex conditional logic, multi-device coordination, and timing constraints that would otherwise require the agent to implement; simpler than building custom automation logic in agent code.
zone-aware device organization and context
Organizes devices into Homey Zones (rooms/areas) and exposes zone membership through MCP resources, enabling agents to understand spatial context and issue zone-scoped commands (e.g., 'turn off all lights in the living room'). Implements zone hierarchy as queryable resources that map device IDs to zone names, allowing agents to reason about device location without explicit configuration.
Unique: Exposes Homey's zone hierarchy as queryable MCP resources, giving agents built-in spatial awareness without requiring manual room/device mapping. Agents can reason about device location and issue zone-scoped commands naturally.
vs alternatives: Unlike generic device APIs that treat all devices equally, zone awareness allows agents to understand and act on spatial context, making interactions more natural and reducing the need for explicit device selection.
llm-optimized context and schema generation
Automatically generates structured schemas and context representations for Homey devices, flows, and zones optimized for LLM consumption. Implements schema inference from Homey device capabilities and produces concise, LLM-friendly descriptions that reduce token usage and improve agent reasoning. Includes heuristics for generating natural language descriptions of device capabilities and constraints.
Unique: Implements LLM-specific schema optimization (compact representations, natural language descriptions, capability inference) rather than exposing raw Homey API responses. Reduces token overhead and improves agent reasoning by providing semantically meaningful context.
vs alternatives: More efficient than raw API wrapping because it pre-processes Homey data into LLM-friendly formats, reducing both token usage and the need for agents to parse verbose API responses.
mcp resource and tool registry with dynamic capability discovery
Implements MCP's resource and tool abstractions to expose Homey devices, flows, and zones as discoverable resources and callable tools. Uses a registry pattern to dynamically map Homey objects to MCP definitions, enabling clients to discover available capabilities at runtime without hardcoded tool definitions. Supports both resource-based queries (read-only state) and tool-based actions (commands).
Unique: Uses MCP's native resource and tool abstractions with dynamic registry pattern, allowing clients to discover Homey capabilities at runtime rather than relying on static tool definitions. Automatically generates MCP schemas from Homey API responses.
vs alternatives: More maintainable than static tool definitions because new Homey devices are automatically exposed without code changes; more standards-compliant than custom APIs because it uses MCP's native abstractions.
homey api authentication and session management
Handles Homey API authentication (OAuth or app token) and manages session lifecycle for MCP connections. Implements credential caching and refresh logic to maintain persistent connections to the Homey hub without requiring re-authentication between requests. Supports both local network and cloud API endpoints with automatic fallback.
Unique: Implements transparent credential management with automatic refresh and fallback between local/cloud endpoints, reducing boilerplate for MCP server implementations. Handles both OAuth and app token authentication patterns.
vs alternatives: Simpler than manual credential management because it handles token refresh and endpoint fallback automatically; more secure than hardcoding tokens because it supports OAuth and credential caching.