gaggiuino-mcp

Gaggiuino MCP Server This is a lightweight Model Context Protocol (MCP) server built for Gaggiuino, the open-source espresso machine controller for the Gaggia Classic. It is designed to integrate easily AI clients that want to display or analyze data from the Gaggiuino system in real time.

This is an article I wrote about this project https://medium.com/@a.klement.w/dialing-in-espresso-using-mcp-server-0207819fe93a

Allows connected clients to:

• Retrieve the current machine status

• Access the latest shot ID

• Fetch shot data for a specified id

Features

📊 Real-time access to shot telemetry

🌐 Designed for local network access

How to use

Using Claude Desktop

{
  "mcpServers": {
      "gaggiuino": {
          "command": "uv",
          "args": [
              "--directory",
              "/ABSOLUTE/PATH/TO/PARENT/FOLDER/gaggiuino-mcp",
              "run",
              "gaggiuino.py"
          ]
      }
  }
}

Installing via Smithery

To install Gaggiuino Espresso Machine Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @AndrewKlement/gaggiuino-mcp --client claude

Available Toolsets

Example

User:

analyze the latest espresso shot data

Claude:

I’ll retrieve and analyze the latest espresso shot data for you. Let me first check the status of your espresso machine and then get the latest shot information. getStatus Now I’ll get the ID of the latest espresso shot: getLatestShotId Let me retrieve the data for shot #188: getShotData Based on the data retrieved, I’ll now analyze your latest espresso shot (ID #188). Here’s my analysis:

Machine Status and Shot Overview Your machine is currently idle at 57.2°C with -0.1 bar pressure. The shot analyzed was taken on April 19, 2025 (based on the timestamp), with a total duration of 26.5 seconds (265 datapoints at 0.1s intervals).