HC3

You can run a local MCP server that exposes Fibaro HC3 control and automation capabilities to AI assistants in your environment. This server bridges your HC3 system with your preferred MCP clients, enabling natural-language driven interactions with devices, scenes, and system information while keeping all communication on your local network.

How to use

Install and start the local MCP server wired to your HC3 system. Then configure your MCP client (such as an AI assistant integration) to connect using the provided stdio MCP entry. Once connected, you can ask your assistant to list devices, control devices, run scenes, fetch status, and manage QuickApps and plugins. Use natural language commands like asking to show all devices, turn on lights, run a scene, or retrieve system information. Ensure your HC3 host, username, and password are correctly supplied in the MCP server configuration so the AI assistant can securely access HC3 resources.

How to install

Prerequisites: you need Node.js installed on your machine. You also need access to your HC3 system over the network and a valid HC3 user account.

1. Ensure you have Node.js installed. Check with node -v and npm -v.

2. Obtain the MCP server tooling or extension package that includes the HC3 MCP server executable. Ensure you have access to the runtime script at the expected path.

3. Run the MCP server using the exact runtime command shown in the configuration example below to start listening for client connections.

4. Verify the MCP server is running and ready to accept connections from your MCP client.

Configuration and usage details

Configuration is designed to be performed for a local, stdio-based MCP server. The server is started as a local process and communicates with your HC3 system using environment variables for credentials.

Environment variables shown for the MCP runtime are:

• FIBARO_HOST: HC3 host address (e.g., 192.168.1.57)
• FIBARO_USERNAME: HC3 username
• FIBARO_PASSWORD: HC3 password
• FIBARO_PORT: HC3 port (default 80)

Security considerations

All communication remains on your local network. Credentials are stored and used by the MCP runtime to authenticate with HC3. Ensure that access to the host running the MCP server is restricted to trusted users and devices.

Troubleshooting

If you encounter issues connecting to HC3, verify the HC3 system is powered on and reachable on the network, confirm the host IP, port, and credentials, and ensure the MCP server process is running. Use the test connection command in your MCP client to confirm accessibility.

Available tools

get_system_info

Get basic HC3 system information.

get_devices

List all devices with filtering options.

get_device

Get specific device details.

control_device

Control device actions such as turnOn, turnOff, setValue, etc.

get_rooms

List all rooms and sections.

get_scenes

List all scenes.

get_scene

Get specific scene details.

start_scene

Execute scenes.

stop_scene

Stop running scenes.

get_device_actions

Get available actions for devices.

get_device_events

Get device event history.

get_global_variables

Manage global variables.

set_global_variable

Set global variable values.

delete_global_variable

Delete global variables.

get_climate_panels

Climate control panel information.

get_climate_zones

Climate zones and settings.

get_climate_schedules

Heating/cooling schedules.

update_climate_schedule

Modify climate schedules.

get_weather_data

Current weather information.

get_alarm_partitions

Alarm system partitions.

get_alarm_zones

Alarm zones configuration.

get_alarm_devices

Security devices list.

arm_alarm_partition

Arm specific alarm partitions.

disarm_alarm_partition

Disarm alarm partitions.

get_users

System users and permissions.

get_user_locations

User location tracking.

get_network_status

Network connectivity status.

get_wifi_networks

Available Wi-Fi networks.

get_network_devices

Connected network devices.

get_sprinkler_zones

Irrigation system management.

control_sprinkler_zone

Sprinkler zone control.

get_custom_events

Custom event definitions.

emit_custom_event

Trigger custom events.

get_system_backups

System backup management.

create_system_backup

Create new backups.

get_system_diagnostics

System health diagnostics.

get_ios_devices

iOS device management.

get_quickapps

Quick Apps management.

get_quickapp_logs

Quick App log analysis.

get_plugins

Get all available plugins including installed and available plugins.

get_installed_plugins

Get list of installed plugins on the system.

get_plugin_types

Get information about all plugin types with categories.

get_plugin_view

Get plugin view/configuration interface for devices.

update_plugin_view

Update plugin view component properties.

call_ui_event

Trigger UI events on plugin interface elements.

create_child_device

Create child devices for plugins (multi-channel devices).

manage_plugin_interfaces

Add or remove interfaces from devices.

restart_plugin

Restart plugins/devices.

update_device_property

Update device property values directly.

publish_plugin_event

Publish various system events through plugin system.

get_ip_cameras

Get available IP camera types for installation.

install_plugin

Install plugins by type.

delete_plugin

Delete/uninstall plugins by type.

get_system_context

Comprehensive system overview.

get_device_relationships

Device relationships and room assignments.

get_automation_suggestions

AI-powered automation recommendations.

get_device_usage_patterns

Device usage analytics and patterns.

explain_device_capabilities

Detailed device capability explanations.

get_hc3_configuration_guide

Complete HC3 configuration documentation.

get_hc3_quickapp_programming_guide

Quick Apps programming reference.

get_hc3_lua_scenes_guide

Lua Scenes programming documentation.

get_hc3_programming_examples

Practical code examples and snippets.

list_quickapp_files

Get list of all source files for a QuickApp.

get_quickapp_file

Get detailed information about a specific QuickApp file including content.

create_quickapp_file

Create new source files for QuickApps.

update_quickapp_file

Update existing QuickApp source files.

update_multiple_quickapp_files

Update multiple QuickApp files at once.

delete_quickapp_file

Delete QuickApp source files (main files cannot be deleted).

export_quickapp

Export QuickApp to .fqa file format (open source or encrypted).

import_quickapp

Import QuickApp from .fqa/.fqax file (requires file upload).