homey

This MCP server provides a bridge to the Homey smart home platform, exposing Homey devices, capabilities, zones, and flows through the MCP API. It enables listing devices, querying device details, adjusting capabilities (such as on/off, brightness, and temperature), listing zones, and triggering Homey Flows. You can query available devices and their capabilities, then issue commands to change device states or start automations, all in a consistent MCP interface. The included tools map to Homey concepts: list_devices returns connected devices with capabilities, get_device fetches device specifics, set_capability adjusts a value on a device, list_zones shows Homey zones, list_flows enumerates automations, and trigger_flow runs a named Flow.

Prerequisites:

• Node.js 18 or newer
• Access to a Homey Pro device with a local API enabled
• A Homey API token and the Homey device local IP

Installation steps:

1. Clone or download the MCP server repository.
2. Install dependencies:

npm install

3. Build the project (if applicable):

npm run build

4. Prepare configuration with environment variables (see configuration section below) and start the server using your preferred method (e.g., node dist/index.js).

Configuration (example):

• Create a .env file or export environment variables:

HOMEY_API_TOKEN=your_api_token_here
HOMEY_LOCAL_IP=192.168.1.xxx

Environment variables are required for authentication and network access to Homey. Ensure the API token has sufficient permissions and that the Homey device is reachable on the local network. If you encounter connection issues, verify that HOMEY_LOCAL_IP is correct and that the token hasn’t expired. The server exposes commands via MCP; use list_devices to discover IDs before calling set_capability or trigger_flow. If you're integrating with Claude Desktop, adjust the path in the configuration example to point to your built index.js and provide the same environment variables.