2025.5.1
Home ▸ Integrations ▸

La Marzocco

This integration interacts with La Marzocco coffee machines through calls to the La Marzocco cloud API.

If your Home Assistant host can perform DHCP discovery, your machine will be discovered automatically. Otherwise, if your machine is in Bluetooth range to your Home Assistant host and the Bluetooth integration is fully loaded, the machine will be discovered as well.

By default, this integration will receive push updates from the cloud about its general status and otherwise query your machine every 30 seconds for an update, every 15 minutes for new statistics, and every hour for a firmware update.

Prerequisites

  • To be able to configure your machine in Home Assistant, your machine needs to be added to your account using the official La Marzocco app first.
  • Only login with username & password is supported. If you are currently using a social login, you need to create a new La Marzocco account and transfer your machine to it to be able to use this integration.

Configuration

To add the La Marzocco device to your Home Assistant instance, use this My button:

La Marzocco can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select La Marzocco.

  • Follow the instructions on screen to complete the setup.

Username

Your username you use to log into the La Marzocco app.

Password

Password you use to log into the La Marzocco app.

Options

Options for La Marzocco can be set via the user interface, by taking the following steps:

  • Browse to your Home Assistant instance.
  • Go to Settings > Devices & Services.
  • If multiple instances of La Marzocco are configured, choose the instance you want to configure.
  • Select the integration, then select Configure.
Use Bluetooth

Allows you to manually disable Bluetooth communication with the machine (if available). This can be used to avoid longer timeouts, e.g., when your machine is only sometimes in range.

Available platforms & entities

= La Marzocco Cloud = Bluetooth

Buttons

Button name Description Available for machines Controllable through
Start backflush Starts the backflush process on your machine. You got 15 seconds to turn the paddle after activation. all

Numbers

Number name Description Available for machines Controllable through Remarks
Coffee target temperature Temperature the coffee boiler is set to all -
Smart standby time Time until the machine will automatically stand by (if enabled) all -
Preinfusion time Duration of preinfusion Linea Micra, Linea Mini, Linea Mini R only available when machine is in mode Preinfusion
Prebrew time on Duration which prebrew will be on Linea Micra, Linea Mini, Linea Mini R only available when machine is in mode Prebrew
Prebrew time off Duration which prebrew will wait Linea Micra, Linea Mini, Linea Mini R only available when machine is in mode Prebrew

Switches

Switch name Description Available for machines Controllable through
Main Allows to turn machines on-/off all
Steam boiler Allows to enable/disable the steam boiler all
Smart standby enabled Whether smart standby is on (machine will automatically stand by after given time) all

Binary sensors

Binary sensor name Description Available for machines Retrievable from Remarks
Water tank empty Indicates whether the water tank needs a refill. all -
Brewing active Is on if you are in the process of making coffee. all -
Backflush enabled Is on if you started the backflushing process. all -
WebSocket connected Track your connection to the cloud WebSocket for real time updates. all Disabled by default.

Sensors

Sensor name Description Available for machines Retrievable from Remarks
Coffee boiler ready time Indicates when the coffee boiler will be ready for brewing. all -
Steam boiler ready time Indicates when the steam boiler will be ready for brewing. all -
Total coffees made How many coffees have been made in total. all -
Total flushes done How often the machine has been flushed. all -
Last cleaning time Indicates when the machine was last cleaned with a Backflush. all -

Updates

Update name Description Available for machines Retrievable from
Gateway firmware Firmware status of the gateway all
Machine firmware Firmware status of the machine all

Selects

Select name Description Options Available for machines Controllable through
Prebrew/-infusion mode Whether to use prebrew, preinfusion, or neither Disabled, Prebrew, Preinfusion Linea Micra, Linea Mini, GS3 AV
Steam level The level your steam boiler should run at 1,2,3 Linea Micra, Linea Mini R
Smart standby mode The smart standby mode, that decides from which events the timer to standby will run. Last brewing, Power on all

Supported devices

Currently, only devices from the “Home” range are supported:

  • Linea Mini
  • Linea Mini R
  • Linea Micra
  • GS3 AV
  • GS3 MP

Possible use-cases

  • Control your machine through voice, allowing you to change boiler temperatures quickly without opening the app.
  • Control your smart coffee scales (tare/timer start) when a brew starts.
  • Turn on lights next to the machine while a brew is running.

Automations

Get started with these automation examples.

Turn steamboiler on when machine is turned on

I often drink milk beverages in the morning and espresso in the afternoon, but forget to re-enable the steamboiler again, so this automation ensures that the steam boiler is always turned on, when the machine is turned on.

Example YAML configuration 
alias: Turn steamboiler on when machine is turned on
description: Ensure the steamboiler is on, when the machine gets turned on
triggers:
  - trigger: state
    entity_id:
      - switch.mr000000
    from: "off"
    to: "on"
conditions:
  - condition: state
    entity_id: switch.mr000000_steam_boiler
    state: "off"
actions:
  - action: switch.turn_on
    target:
      entity_id: switch.mr000000_steam_boiler
    data: {}
mode: single

Known Limitations

  • Only La Marzocco native app accounts are supported, social logins (Google, Apple & WeChat) are not supported
  • Currently it is only possible to view the schedules configured in the La Marzocco Home app, but not to edit the schedules from Home Assistant. You can, of course, build Home Assistant native automations to reflect the same functionality in Home Assistant.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.

Troubleshooting

Problem: Connection to machine is not possible

Check the La Marzocco Home app to see if you can connect to your machine there. If not, remove the machine and add it again (follow the instructions in the La Marzocco App).