fibaro-mcp-server

kaeljune/fibaro-mcp-server

3.2

If you are the rightful owner of fibaro-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Server to control Fibaro Home Center 3 via Claude.

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
  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. 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.