fibaro_set_device_value
Set advanced device properties like temperature setpoints, modes, or custom values for Fibaro HC3 devices. Use this tool to configure specific parameters using device ID, property name, and desired value.
Instructions
Set a specific property value for a device. Use this ONLY for advanced properties like temperature setpoints, modes, or custom device properties. Do NOT use for brightness (use fibaro_set_brightness) or colors (use fibaro_set_color).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Device ID | |
| property | Yes | Property name to set (e.g., "targetTemperature", "mode", "state") | |
| value | Yes | Value to set |
Implementation Reference
- src/index.ts:451-467 (handler)The tool handler that executes the fibaro_set_device_value logic by extracting parameters and delegating to FibaroClient.setDeviceValue.case 'fibaro_set_device_value': { if (!this.fibaroClient) { throw new Error('Not connected to Fibaro HC3. Please check your configuration and restart the MCP server.'); } const deviceId = args?.id as number; const property = args?.property as string; const value = args?.value; await this.fibaroClient.setDeviceValue(deviceId, property, value); return { content: [ { type: 'text', text: `Successfully set device ${deviceId} property '${property}' to '${value}'`, }, ], }; }
- src/index.ts:192-213 (schema)Input schema and description for the fibaro_set_device_value tool, used for validation and tool listing.{ name: 'fibaro_set_device_value', description: 'Set a specific property value for a device. Use this ONLY for advanced properties like temperature setpoints, modes, or custom device properties. Do NOT use for brightness (use fibaro_set_brightness) or colors (use fibaro_set_color).', inputSchema: { type: 'object', properties: { id: { type: 'number', description: 'Device ID', }, property: { type: 'string', description: 'Property name to set (e.g., "targetTemperature", "mode", "state")', }, value: { type: ['string', 'number', 'boolean'], description: 'Value to set', }, }, required: ['id', 'property', 'value'], }, },
- src/fibaro-client.ts:134-142 (helper)Supporting utility in FibaroClient that performs the actual API call to set a device property.async setDeviceValue(id: number, property: string, value: any): Promise<void> { try { await this.client.post(`/api/devices/${id}/action/setProperty`, { args: [property, value] }); } catch (error) { throw new Error(`Failed to set device ${id} property ${property} to ${value}: ${error}`); } }