Homey MCP Server

A Model Context Protocol (MCP) server for integrating with Homey Pro smart home system. This server provides access to Homey devices, zones, variables, and logic through the MCP protocol.

🏠 Features

• Devices: Retrieve and search all Homey devices
• Zones: List all zones in your home
• Variables: Access to Homey variables
• Logic: Retrieve information about logic flows
• Temperature: Specialized functions for temperature sensors
• Cache: Automatic data caching for better performance

📁 Project Structure

homey-mcp/
├── src/                     # Main source code
│   ├── server.js           # MCP server main file
│   ├── homey.js           # Homey API client
│   ├── entities.js        # Data models (Device, Zone, Variable, etc.)
│   └── index.js           # Standalone test script
├── scripts/                # Test and verification scripts
│   ├── test-mcp.sh        # Main test script
│   ├── verify-mcp.sh      # Quick verification
│   ├── test-temperature.sh # Test temperature functions
│   ├── interactive-test.sh # Interactive testing
│   ├── status-check.sh    # Status check
│   └── final-verification.sh # Comprehensive test
├── config/                 # Configuration files
│   └── .env.example       # Example environment variables
├── cache/                  # Cache files (auto-generated)
│   ├── devices.json
│   ├── zones.json
│   ├── variables.json
│   └── logic.json
├── .env                    # Your environment variables
├── package.json
├── claude_desktop_config.json # Claude Desktop configuration
└── README.md

🚀 Setup

1. Clone and install dependencies

git clone 
cd homey-mcp
npm install

2. Configure environment variables

Copy the example file and fill in your values:

cp config/.env.example .env

Edit .env and add:

• HOMEY_TOKEN: Your Homey API token (get this from Homey Developer Tools)
• HOMEY_ID: Your Homey ID (found in Homey Pro settings)

3. Test the setup

# Test basic functionality
npm start

# Test MCP server
npm run mcp

🔧 Usage

As MCP Server

The server can be used with Claude Desktop or other MCP-compatible clients:

npm run mcp

As Standalone Script

For testing and development:

npm start

With Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "homey": {
      "command": "node",
      "args": ["/path/to/homey-mcp/src/server.js"],
      "env": {
        "HOMEY_TOKEN": "your_token_here",
        "HOMEY_ID": "your_homey_id_here"
      }
    }
  }
}

🛠️ Available Tools

get_homey_devices

Get all devices or filter by zone.

Parameters:

• zone (optional): Filter devices by zone name

search_homey_devices

Search for devices based on name or properties.

Parameters:

• query: Search text

get_homey_zones