Fibaro HC3

Fibaro HC3

MCP server for Fibaro Home Center 3 smart home systems.

2
Stars
1
Forks
0
Releases

Overview

An MCP server that bridges AI-powered applications with Fibaro HC3 smart home systems, enabling natural language interactions to manage rooms, devices, and scenes. It implements the MCP protocol with actions grouped under Room Management (list_rooms, get_room), Device Control (list_devices, get_device, call_device_action), Scene Management (list_scenes, get_scene, execute_scene, kill_scene), and System Tools (test_connection). The server talks to Fibaro HC3 via its REST API (rooms, devices, scenes) and exposes an MCP transport layer that can run over STDIO or HTTP. When using HTTP transport, the server provides an endpoint at /mcp with POST for client requests, GET for server-to-client SSE notifications, and DELETE to terminate sessions; requests can be authenticated with an x-api-key header. The project includes quick-start steps, configuration via a .env file (HC3_HOST, HC3_USERNAME, HC3_PASSWORD, MCP_TRANSPORT_TYPE, etc.), and Docker deployment options. It also includes integration examples (Claude Desktop) and an MCP Inspector development tool, which exposes a debugging web interface at http://localhost:6274/ during dev. It leverages the Fibaro HC3 REST API paths: /api/rooms, /api/devices, /api/scenes.

Details

Owner
coding-sailor
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Room Management

Expose MCP actions to list rooms and fetch details for specific rooms.

Device Control

Expose MCP actions to list devices, inspect device details, and perform actions like turnOn, turnOff, toggle, and setValue.

Scene Management

Expose MCP actions to list scenes, get scene details, execute scenes (async or sync), and kill running scenes.

System Tools

Provide connectivity checks to the HC3 system via test_connection.

Audience

DevelopersIntegrate LLM-powered assistants with Fibaro HC3 via MCP for device and scene control.
MCP ClientsConfigure Claude Desktop or HTTP clients to connect to the MCP server.
Home Automation EngineersEnable natural language control and automation of HC3 environments.

Tags

MCPFibaro HC3Home Center 3Smart HomeAI IntegrationRoom ManagementDevice ControlScene ManagementHTTP transportSTDIO transportDocker