Fibaro HC3 MCP Server

⚠️ DEMO VERSION DISCLAIMER
This is a demonstration/educational version of the Fibaro HC3 MCP Server. It is NOT a commercial product and is provided as-is for learning and testing purposes only. Use at your own risk.

An MCP (Model Context Protocol) Server for controlling Fibaro Home Center 3 through Claude AI.

Features

• Auto-connect to Fibaro HC3 on startup (one-time configuration)
• Retrieve information about devices, scenes, and rooms
• Control devices (turn on/off, set values, brightness, colors)
• Run and stop scenes
• Full Claude AI integration for natural language control
• Support for RGB lights with color name mapping
• HTTP/HTTPS protocol support

Installation

🚀 Quick Installation (Recommended)

One-command installation - no need to clone the repository:

curl -sSL https://raw.githubusercontent.com/kaeljune/fibaro-mcp-server/main/quick-install.sh | bash

This script will:

• ✅ Check dependencies (git, node.js, npm)
• ✅ Choose your AI client (Claude Desktop or Cursor)
• ✅ Automatically clone the repository
• ✅ Ask for Fibaro HC3 connection details
• ✅ Test the connection
• ✅ Install dependencies and build the project
• ✅ Configure your AI client automatically
• ✅ Ready to use!

📋 Manual Installation

If you prefer to install manually:

1. Clone this repository:

git clone https://github.com/kaeljune/fibaro-mcp-server.git
cd fibaro-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Run the configuration script:

./install-claude.sh

Usage

After installation, no manual connection required. The MCP server will automatically connect to Fibaro HC3 when your AI client (Claude Desktop or Cursor) starts.

Supported AI Clients

• Claude Desktop - Full MCP support
• Cursor - MCP integration for AI-powered coding

1. View Device List

Show all devices

2. Control Lights

Turn off light number 3

Turn on living room light

Set light number 5 brightness to 50%

3. Control RGB Lights

Change RGB light number 10 to red

Set RGB light number 10 to purple (255,0,255,0)

4. Run Scenes

Run scene "Good Night"

Available Commands

Information

• fibaro_get_devices: Get list of all devices
• fibaro_get_device: Get detailed device information by ID
• fibaro_get_scenes: Get list of all scenes
• fibaro_get_scene: Get detailed scene information by ID
• fibaro_get_rooms: Get list of all rooms

Control

• fibaro_turn_on_device: Turn on device by ID
• fibaro_turn_off_device: Turn off device by ID
• fibaro_set_device_value: Set property value for device
• fibaro_set_brightness: Set brightness for lights/dimmers (0-100%)
• fibaro_set_color: Set RGB color for RGB lights (R,G,B,W: 0-255)
• fibaro_control_rgb_light: Complete RGB light control (on/off + color + brightness)
• fibaro_run_scene: Run scene by ID
• fibaro_stop_scene: Stop scene by ID

Integration Examples

After configuration, you can talk to Claude like:

• "Turn off all lights in the house"
• "Turn on bedroom light"
• "Run good morning scene"
• "Show status of all sensors"
• "Set living room light brightness to 50%"
• "Change living room RGB light to green"
• "Set RGB light number 5 to light purple"

Claude will automatically:

1. Connect to Fibaro HC3 (if not already connected)
2. Find matching devices/scenes
3. Execute control commands
4. Report results

Security

• This server only connects locally to Fibaro HC3
• Login credentials are stored securely in MCP configuration
• Supports both HTTP and HTTPS with self-signed certificate acceptance
• No sensitive information is stored in logs

Troubleshooting

Cannot connect to Fibaro HC3

• Re-run the installation script: ./install-claude.sh
• Check IP address and port (default HTTP: 80, HTTPS: 443)
• Ensure username/password are correct
• Check firewall and network connectivity
• Try accessing HC3 web interface from browser

MCP Server not working

• Check the path in Claude configuration
• Ensure project has been built (npm run build)
• Restart Claude Desktop after configuration changes
• Check Claude Desktop logs for detailed error messages

Changing Fibaro HC3 connection information

To change IP, username, or password:

1. Re-run the installation script: ./install-claude.sh
2. Enter new information
3. Restart Claude Desktop

License

This is a demo/educational project. Not for commercial use.