Homey
About
Interact with Homey to control smart home system. Supports devices, flows, and zones. Contains a few goodies for better integrations with LLMs.
Details
- Author
- pigmej
- Downloads
- 325
- Categories
- Other
Jump to
- Device management with full capability support
- Zone browsing and management
- Flow listing and triggering
- System configuration management
- AI-powered context-aware prompts for guidance
- Intelligent resource caching with stale data fallback
- Pagination support for large datasets
- Comprehensive error handling with detailed messages
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
HomeyCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the HOMEY_API_URL and HOMEY_API_TOKEN environment variables, then run the server using uvx, Docker, or install it directly into MCP clients (Claude Desktop, Claude Code, Cursor) via FastMCP CLI.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"homey": {
"python-homey-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"python-homey-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}HomeyPro MCP Server
A Model Context Protocol (MCP) server for interacting with HomeyPro home automation systems. This server provides paginated access to devices, zones, and flows with comprehensive management capabilities.
Features
- Device Management: List, search, and control devices with full capability support
- Zone Management: Browse zones and their associated devices
- Flow Management: List and trigger automation flows
- System Management: Get and update system configuration (location, address, language, units)
- AI-Powered Prompts: Context-aware guidance for device control, troubleshooting, and automation
- Resource Caching: Efficient data access with intelligent caching and stale data fallback
- Pagination Support: Efficient handling of large datasets with cursor-based pagination
- Real-time Data: Get current device states, capabilities, and insights
- Error Handling: Comprehensive error handling with detailed error messages
Installation
Local Development
1. Clone the repository and navigate to the project directory:
cd python-homey-mcp
2. Install dependencies using uv:
uv sync
Docker
Pull the pre-built Docker image:
docker pull ghcr.io/pigmej/python-homey-mcp:latest
No additional installation steps are required when using Docker.
Configuration
Before running the server, you need to configure your HomeyPro connection:
Environment Variables
Set the following environment variables:
export HOMEY_API_URL="http://YOUR_HOMEY_IP_ADDRESS"
export HOMEY_API_TOKEN="YOUR_PERSONAL_ACCESS_TOKEN"
Getting Your HomeyPro Token
1. Open the HomeyPro web interface
2. Go to Settings > General > API
3. Create a new Personal Access Token
4. Copy the token and set it as the HOMEY_API_TOKEN environment variable
Finding Your HomeyPro IP Address
You can find your HomeyPro's IP address in:
- HomeyPro web interface: Settings > General > Network
- Your router's admin panel
- HomeyPro mobile app: More > Settings > General > Network
Usage
Running the Server
Using uvx (Recommended)
The easiest way to run the server is using uvx:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
