Homey-Wan-Kenobi MCP

Get real-time power consumption broken down by zone and device. Returns watts (W) currently being consumed. Useful for answering 'what is using power right now?'

Get energy consumption report for a specific period. Returns kWh consumed per device. Useful for 'how much energy did I use today/this week/this month?'

Get the full definition of a standard (WHEN/AND/THEN) Flow by ID, including its trigger, conditions and actions cards.

Get the full definition of one flow card (by type + id), including its arguments (names, types, dropdown values, ranges). Use this to learn exactly what args a card needs when building a flow.

Get historical data points for an insight log. Returns timestamped values (e.g. temperature readings over time). Use list_insights first to find the log ID.

Get LED ring screensaver options and current setting.

Get Homey's configured geographic location (address and GPS coordinates). Used for sunrise/sunset calculations and weather.

Get Homey memory usage breakdown by app and system component. Useful for identifying memory-hungry apps.

Get home/away and awake/asleep status for all household members. Useful for 'is anyone home?' or 'who is home?'

Get current API session details including authenticated user, role, and permission scopes.

Get Homey storage usage breakdown. Shows how much disk space is used by apps, insights, and system.

Get Homey system information including software version, hostname, Wi-Fi network, and hardware details.

Check for available Homey system updates and current update settings (channel, auto-update).

Get current weather conditions at Homey's location. Returns temperature, humidity, pressure, wind, and weather state (e.g. 'clear sky', 'overcast clouds').

Get hourly weather forecast at Homey's location. Returns temperature and weather conditions for upcoming hours.

Get recent Z-Wave network log entries. Shows transmit failures, routing issues, and network events. Essential for diagnosing Z-Wave device connectivity problems.

Advanced escape hatch: call any Homey Web API endpoint directly. method is GET/POST/PUT/DELETE; path is the API path (e.g. /manager/zwave/state); body is an optional JSON object. Use to reach endpoints not yet wrapped by a dedicated tool, including new firmware capabilities. Prefer the dedicated tools when one exists.

List all alarms and timers with their schedule and repetition days.

List all installed Homey apps with version, enabled status, and origin (appstore or devkit). Apps provide device drivers, flow cards, and integrations.

List all Homey devices with current capability values. Returns device ID, name, class, zone, availability, capabilities, and live sensor/state values. Use 'zone' to filter by room name (partial match) or 'class' to filter by device type (light, sensor, thermostat, speaker, lock, socket, etc).

List all available device drivers (protocol integrations). Useful for troubleshooting — shows which drivers are ready.

List available flow cards of a given type (trigger/condition/action). There are hundreds, so filter by a substring matched against the card id/title/uri (e.g. a device UUID to find that device's cards, or 'windowcoverings', 'dim', 'button'). Returns id + title. Use get_flow_card for full args.

List all automation flows (simple and advanced). Returns flow ID, name, enabled/broken status, and type. Flows are Homey's automations with WHEN/AND/THEN logic.

List all available insight logs (sensor history, energy meters, etc). Returns log ID, title, data type, and units. Use the log ID with get_insight_entries to retrieve historical data.

List all moods (scenes/presets) per zone. Moods save device states that can be activated together (e.g. 'Movie Mode' dims lights and closes blinds).

List the 50 most recent Homey notifications (app updates, alerts, system messages). Sorted newest first.

List all logic variables with their current values. Logic variables store state (boolean, number, string) that can be used in flow conditions and actions.

List all zones (rooms/areas) in the home with their hierarchy. Returns zone ID, name, parent zone, and icon. Zones are organized in a tree: Home → Floors → Rooms.

Move a device to a different zone (room). Use list_zones for the zone ID and list_devices for the device ID.

Reboot the Homey Pro. Takes 2-3 minutes to come back online. Use this to resolve stale devices or Z-Wave/Zigbee mesh issues after firmware updates.

Rename a device. Use list_devices to find the device ID.

Restart a Homey app. Useful when devices from that app are unresponsive. Use list_apps to find the app ID (e.g. 'com.fibaro').

Search devices by name, device class, or capability name. Returns matching devices with their current values. Useful for finding devices when you don't know the exact ID — e.g. search 'temperature' to find all temperature sensors, or 'kitchen' to find devices with kitchen in the name.

Create a new alarm or update an existing one. Specify time in HH:MM format and optionally which days to repeat.

Control a device by setting a capability value. Common capabilities: 'onoff' (boolean — turn on/off), 'dim' (number 0-1 — brightness), 'target_temperature' (number — thermostat setpoint), 'volume_set' (number 0-1). Use get_device first to see available capabilities and their current values.

Enable or disable a flow automation. Disabled flows won't trigger. Use list_flows to find the flow ID.

Set the LED ring screensaver animation. Use get_ledring to see available options (e.g. 'spectrum', 'off').

Activate a mood (scene) in a zone. This sets all devices in the mood to their saved states.

Set your own presence (home/away) or sleep state (awake/asleep). This affects presence-based automations.

Set the Homey system name (visible in network discovery and the Homey app).

Set the value of a logic variable. The value type must match the variable type (boolean, number, or string).

Trigger (run) a flow immediately by its ID. Tries simple flow first, then advanced flow. Use list_flows to find the flow ID.

Permanently uninstall a Homey app and remove all its devices. This cannot be undone.

Update an existing Advanced Flow. Pass only the fields to change (name, enabled, and/or the full cards map). Replacing cards replaces the entire flow graph, so fetch with get_advanced_flow first and send the complete cards object. Returns broken status.

Update a standard Flow. Pass the flow id and a 'flow' object with only the fields to change (name, trigger, conditions, actions, enabled).