MCP Servers

Homey MCP Server

Enables natural language control of Homey Pro smart home systems, including devices, flows, zones, energy monitoring, weather, alarms, and system management, with 43 tools and troubleshooting prompts.

README

Homey MCP Server

MCP server for controlling Homey Pro smart home systems through the Model Context Protocol.

43 tools and 3 knowledge prompts for device control, automation, monitoring, troubleshooting, and more.

Quick Start

git clone https://github.com/homey-mcp/homey-mcp.git
cd homey-mcp
npm install
npm run build

Authenticate with your Homey:

npx homey login
npx homey select

Add to your MCP client config (Kiro, Claude Desktop, Cline, etc.):

{
  "mcpServers": {
    "homey": {
      "command": "node",
      "args": ["/path/to/homey-mcp/dist/index.js"]
    }
  }
}

Authentication

The server supports two authentication methods:

Homey CLI (recommended) — Run npx homey login and npx homey select. The server reads the stored OAuth token from ~/.athom-cli/settings.json automatically.

Local API Key — Create an API key at my.homey.app, then set environment variables:

export HOMEY_ADDRESS=http://192.168.1.x
export HOMEY_TOKEN=your-api-key

Tools

Devices

Tool	Description
`list_devices`	List devices, filter by zone or class
`get_device`	Get device details with all capability values
`search_devices`	Search by name, class, or capability
`set_device_capability`	Control a device (on/off, dim, temperature, etc.)

Zones & Flows

Tool	Description
`list_zones`	List all zones (rooms/areas)
`list_flows`	List simple and advanced flows
`trigger_flow`	Run a flow
`set_flow_enabled`	Enable or disable a flow

Logic & Apps

Tool	Description
`list_variables`	List logic variables
`set_variable`	Set a variable value
`list_apps`	List installed apps
`restart_app`	Restart a Homey app
`enable_app`	Enable or disable an app
`uninstall_app`	Uninstall an app

Insights & Energy

Tool	Description
`list_insights`	List available insight logs
`get_insight_entries`	Get historical sensor data
`get_energy_live`	Live power consumption by zone/device
`get_energy_report`	Energy report for day/week/month/year

Weather & Presence

Tool	Description
`get_weather`	Current weather at Homey's location
`get_weather_hourly`	Hourly weather forecast
`get_presence`	Home/away status for all users
`set_presence`	Set your presence or sleep state
`get_location`	Homey's configured location

Alarms & Moods

Tool	Description
`list_alarms`	List all alarms/timers
`set_alarm`	Create or update an alarm
`delete_alarm`	Delete an alarm
`list_moods`	List moods (scenes) per zone
`set_mood`	Activate a mood in a zone

Notifications & System

Tool	Description
`list_notifications`	List recent notifications
`create_notification`	Send a notification
`get_system_info`	System info (version, wifi, hostname)

Infrastructure & Protocols

Tool	Description
`list_drivers`	List all available device drivers
`get_zwave_log`	Z-Wave network log for troubleshooting
`get_backup_status`	Backup config and last backup time
`create_backup`	Schedule a new backup
`get_ledring`	LED ring screensaver options
`set_ledring`	Set LED ring screensaver
`get_updates`	Check for system updates
`get_session`	Current API session info
`reboot_homey`	Reboot the Homey Pro
`get_memory_info`	Memory usage by app/component
`get_storage_info`	Storage usage breakdown
`set_system_name`	Set the Homey system name

Prompts

Built-in knowledge prompts accessible via the MCP prompts API:

Prompt	Description
`homey_best_practices`	Zone architecture, device naming, protocol tips, energy management, security
`homey_troubleshooting`	Diagnosing offline devices, Z-Wave/Zigbee issues, flow debugging, performance
`homey_flow_patterns`	Automation patterns, naming conventions, anti-patterns to avoid

Development

npm run dev        # Run with tsx (no build step)
npm run build      # Compile TypeScript
npm run lint       # ESLint
npm run typecheck  # TypeScript strict check
npm start          # Run compiled version

Tech Stack

TypeScript + Node.js (≥20)
homey-api v3 — Official Homey Web API client
@modelcontextprotocol/sdk v1.26 — MCP server (registerTool with ToolAnnotations)
zod — Parameter validation

License

MIT

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured