Skip to content
MCU Atlas
ESP32ESP32-S3Draft

GaggiMate: ESP32 smart-control upgrade for Gaggia espresso machines

Adds a touchscreen, PID temperature control, brew timer and steam modes to a Gaggia Classic via ESP32 boards.

Difficulty:ExpertCost:Source available

Photos

GaggiMate: ESP32 smart-control upgrade for Gaggia espresso machines photo 1
GaggiMate: ESP32 smart-control upgrade for Gaggia espresso machines photo 2
GaggiMate: ESP32 smart-control upgrade for Gaggia espresso machines photo 3

Photos: jniebuhr/gaggimate

Key Facts

  • Chip: ESP32-S3 (display) + controller board
  • Display: round touch screen
  • Control: PID boiler temperature, pump, solenoid
  • Safety: mains voltage

About This Project

GaggiMate retrofits Gaggia espresso machines with a round touch display and a controller board that manages boiler temperature, pump and valve. You get PID temperature control, brew timers, steam and hot-water modes, and safety shutoffs, plus an active community. Kits are sold by the project, and the code is open under a non-commercial licence. This involves mains voltage inside an appliance, so it is only for experienced builders.

Source & Attribution

Source: GitHub
License: CC-BY-NC-SA-4.0 (per README badge; GitHub reports none)
Last verified: 10/16/2026
GaggiMate: ESP32 smart-control upgrade for Gaggia espresso machines
How to Build It
GaggiMate is an open-source smart controller for Gaggia Classic espresso machines. A round ESP32-S3 touchscreen talks to a controller board that handles PID boiler temperature control, the pump and the solenoid, and adds shot profiles, a web UI and Home Assistant support.
Draft: steps not yet verified

Parts Needed

  • GaggiMate kit (round ESP32-S3 display + controller board), or boards built from the repo's hardware files
  • Wiring harness and thermocouple/sensor for your machine
  • 3D-printed display mount
  • USB data cable

Steps

  1. 1

    Read the safety notes

    This modification wires into a mains-powered appliance. Unplug the machine, follow the docs exactly, and leave the job to a qualified person if you aren't confident.

  2. 2

    Get the hardware

    Buy the kit from the 'How to buy' section, or have the controller PCB made from the repo's hardware files.

  3. 3

    Install in the machine

    Following the GaggiMate docs, fit the controller and connect the boiler, pump, solenoid and temperature sensor in place of the stock controls.

  4. 4

    Flash the firmware

    Use the web flasher from the documentation to install the display and controller firmware over USB.

  5. 5

    Configure

    Connect the display to Wi-Fi, set your brew and steam temperatures, and create shot profiles. Optionally connect it to Home Assistant or use the WebSocket API.

  6. 6

    License note

    The design is CC BY-NC-SA 4.0. You're free to build and modify it, but you can't sell it commercially.

Parts List (BOM)
Partial parts list
partial
PartQtyRoleEst. PriceBuy
Shown as creator specifies; mains-powered appliance
1controller$150–$250View
Estimated Total$150–$250 USD

Not included: 3D-printed case, wire, solder, USB cable

Download CSV

Related Projects

Watchy: open-source ESP32 e-ink smartwatch
Illustration
ESP32Draft
An open-source smartwatch with a 1.54in e-paper screen and ESP32, hackable watch faces in Arduino.
Beginner·Under $15·Code
2 parts listed
Low-power ESP32 e-paper weather display (7.5in)
Illustration
ESP32Draft
A wall-mounted 7.5in e-paper weather display on an ESP32 that runs for months on one battery charge.
Intermediate·Cost varies·Code
5 parts listed
OpenEPaperLink: reuse e-ink shelf labels with an ESP32 access point
Illustration
ESP32ESP32-S3Draft
Turns cheap second-hand electronic shelf labels into a Wi-Fi-managed e-ink display fleet via an ESP32 access point.
Advanced·Under $15·Code
3 parts listed