Fibaro MCP Server

🚀 Fibaro HC3 MCP Server

An MCP (Model Context Protocol) Server for controlling Fibaro Home Center 3 through Claude AI, enabling seamless home automation control.

🚀 Quick Start

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.

✨ Features

• Auto-connect: Automatically connect to Fibaro HC3 on startup with one-time configuration.
• Information Retrieval: Retrieve details about devices, scenes, and rooms.
• Device Control: Control devices, including turning them on/off, setting values, brightness, and colors.
• Scene Management: Run and stop scenes effortlessly.
• Claude AI Integration: Fully integrate with Claude AI for natural language control.
• RGB Light Support: Provide support for RGB lights with color name mapping.
• Protocol Compatibility: Support both HTTP/HTTPS protocols.

📦 Installation

🚀 Quick Installation (Recommended)

You can use the one-command installation without cloning the repository:

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

This script will perform the following steps:

• ✅ Check dependencies such as git, node.js, and npm.
• ✅ Let you choose your AI client (Claude Desktop or Cursor).
• ✅ Automatically clone the repository.
• ✅ Prompt you for Fibaro HC3 connection details.
• ✅ Test the connection.
• ✅ Install dependencies and build the project.
• ✅ Automatically configure your AI client.
• ✅ Get the system ready to use!

📋 Manual Installation

If you prefer manual installation, follow these steps:

1. Clone the 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 Examples

Basic Usage

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

Supported AI Clients

• Claude Desktop: Offers full MCP support.
• Cursor: Provides MCP integration for AI-powered coding.

View Device List

Show all devices

Control Lights

Turn off light number 3

Turn on living room light

Set light number 5 brightness to 50%

Control RGB Lights

Change RGB light number 10 to red

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

Run Scenes

Run scene "Good Night"

Advanced Usage

After configuration, you can communicate with Claude using natural language, such as:

• "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 perform the following steps:

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

📚 Documentation

Available Commands

Information Commands

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

Control Commands

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

🔧 Technical Details

Security

• This server only connects locally to Fibaro HC3.
• Login credentials are securely stored in the MCP configuration.
• It supports both HTTP and HTTPS, accepting self - signed certificates.
• No sensitive information is stored in the logs.

Troubleshooting

Cannot connect to Fibaro HC3

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

MCP Server not working

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

Changing Fibaro HC3 connection information

To change the IP, username, or password:

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

📄 License

This is a demo/educational project and is not for commercial use.