v3.0.0 — Advanced Automation & Analytics

v3.0.0 — Advanced Automation & Analytics

Version 3.0 brings 10 new tools for automation, analytics, and external integrations to the Fibaro MCP server.

New Tools

Tool	Description
fibaro_template	Scene templates with {{placeholder}} substitution
fibaro_history	Device state history with time-based aggregation
fibaro_scene_history	Scene execution tracking and performance metrics
fibaro_backup	System backup/restore (JSON/YAML) with dry-run mode
fibaro_repl	Interactive Lua REPL with scene-based sandboxing
fibaro_bulk	Bulk device operations with query-based selection
fibaro_analytics	Usage analytics, energy trends, system health dashboard
fibaro_energy_graph	Historical power/energy data from HC2 summary-graph API
fibaro_integration	Webhook server and MQTT bridge for external services
fibaro_automation	Automation builder — JSON definitions to Fibaro Lua code

Highlights

• 80+ total tools with ~95% Fibaro API coverage
• 369 unit tests (114 new)
• All v3 tools use the op parameter (e.g., fibaro_analytics op=dashboard)
• Helpful error messages when LLMs use wrong parameter names
• Fully backward compatible with v2

Installation

npx fibaro-mcp

Or pin the version:

npx fibaro-mcp@3.0.0

Documentation

• FEATURES.md — Complete feature reference
• TEMPLATES.md — Scene templates
• ANALYTICS.md — Analytics and insights
• INTEGRATIONS.md — Webhooks and MQTT
• AUTOMATION.md — Automation builder

Full Changelog: v2.0.0...v3.0.0

v2.0.0 - Quick Wins + Lua Validation

v2.0.0 - Quick Wins and Lua Code Validation

This release adds developer experience improvements and Lua code validation.

New Features

Lua Code Validation

• Pre-upload Lua syntax validation using luaparse (Lua 5.2)
• Validates code before sending to Fibaro to catch syntax errors early
• Detailed error messages with line/column information
• Integrated into createScene, updateScene, createQuickApp, updateQuickAppCode

Developer Experience Improvements

• ESLint configuration with TypeScript-aware rules
• Prettier code formatting (semi, trailing commas, 100 char width)
• Structured logging with configurable levels (ERROR, WARN, INFO, DEBUG)
  • Set FIBARO_LOG_LEVEL environment variable
  • DEBUG mode logs API requests/responses with timing
• Enhanced error messages with detailed diagnostics and troubleshooting tips
• JSDoc comments on key methods for better IDE support

Technical Details

• 136 tests passing (29 new tests for Lua validator)
• 98.56% test coverage maintained
• All code formatted with Prettier
• All code linted with ESLint

Upgrade Notes

From v1.0.0:

• Optional: Set FIBARO_LOG_LEVEL=DEBUG for detailed API logging
• Lua code is now validated before upload (validation failures will throw errors)

Installation

npm install -g fibaro-mcp@2.0.0

Full Changelog

• feat: add Lua code validation with luaparse
• feat: add structured logging with configurable levels
• feat: add ESLint and Prettier configuration
• feat: enhance error messages with diagnostics
• docs: add JSDoc comments to key methods
• ci: migrate to npm trusted publishing with provenance
• test: add 29 comprehensive Lua validator tests

v1.0.0 - Initial Release

Initial Release

First stable release of fibaro-mcp - Model Context Protocol server for Fibaro Home Center integration.

Features

• Full Fibaro Home Center API integration
• Device management (list, get, control)
• Scene management (list, get, create, update, execute, delete)
• Quick App management (list, get, create, update, delete)
• Room and section management
• Variable management
• User management
• First-run setup tool
• Intent-based API (minimal, standard, full toolsets)
• Comprehensive error handling with diagnostics
• 98.56% test coverage

Technical Details

• Node.js 22+ required
• TypeScript with strict mode
• Vitest for testing
• Published to npm with provenance attestation

Installation

npm install -g fibaro-mcp@1.0.0
# or with dist-tag
npm install -g fibaro-mcp@legacy

Configuration

See QUICKSTART.md for setup instructions.

---

Note: This is the pre-tool-reduction release tagged as legacy on npm. For the latest features, see v2.0.0 or install with npm install -g fibaro-mcp (defaults to latest).