Advertise
MCP.so
Sign In
H

Homey MCP Server

@pigmej

Repository

Basic information

Category

Other

Transports

stdio

Author

pigmej

Submitted by

Jędrzej Nowak

About Homey MCP Server

# HomeyPro MCP Server

#homeypro#home-automation#mcp-server

Homey MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "python-homey-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Homey MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Homey Mcp?

A Model Context Protocol (MCP) server for interacting with HomeyPro home automation systems, providing paginated access to devices, zones, and flows with comprehensive management capabilities.

How to use Homey Mcp?

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.

Key features of Homey Mcp

  • 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

Use cases of Homey Mcp

  • Control and monitor HomeyPro devices via AI assistants
  • Create, debug, and optimize automation flows
  • Organize and browse zones and device hierarchies
  • Perform system health checks and diagnostics
  • Discover device capabilities and control patterns

Frequently asked questions

1

What environment variables are required?

`HOMEY_API_URL` (the IP address of your HomeyPro) and `HOMEY_API_TOKEN` (a personal access token from HomeyPro settings).

2

How do I obtain a HomeyPro API token?

Go to the HomeyPro web interface, navigate to Settings > General > API, and create a new Personal Access Token.

3

What transport protocols does the server support?

HTTP transport (recommended for testing) and STDIO transport (for MCP clients).

4

Can I run the server in Docker?

Yes, a pre-built Docker image is available at `ghcr.io/pigmej/python-homey-mcp:latest`. Run it with the required environment variables.

5

What data is cached and for how long?

System overview (5 min TTL), device registry (30 sec), zone hierarchy (5 min), and flow catalog (2 min). When HomeyPro is unreachable, stale cached data is returned with staleness indicators.

Comments

More Other MCP servers

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Advertise