La Marzocco MCP
Read La Marzocco machine data by default, with optional setting changes when write tools are enabled.
List machines on the account.
Read current machine status: power, boilers, pre-brewing, back flush.
Read settings: firmware, wifi signal, plumb-in, auto-update.
Read statistics widgets from the La Marzocco app.
Read firmware update status.
Read smart standby, wake/sleep schedules, and early start settings.
Read total coffee and flush counters.
Read the latest shots, newest first, including extraction time, dose mode, and temperature.
Read coffee and flush trends per day for up to 30 days.
With write tools enabled, change power, steam, steam level, coffee temperature, pre-extraction, and smart standby.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@La Marzocco MCP what was my last shot?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
lamarzocco-mcp
Unofficial. This project is not affiliated with, endorsed by, or supported by La Marzocco.
An MCP server that lets Claude and other MCP clients read the status, settings and shot data of La Marzocco home espresso machines, and optionally change a few settings. It runs locally over stdio and is built on pylamarzocco.
Ask things like "what was my last shot?", "is the machine on?" or, with write tools enabled, "turn on the machine".
Supported machines
Developed and tested on a Linea Micra. Other models supported by pylamarzocco should work; see docs/capabilities.md for what has been verified per model.
Related MCP server: AppleScript Automation MCP
Requirements
uv (it installs Python 3.13 for you if needed)
A La Marzocco account that uses a regular email/password login (not Google or Apple sign-in)
The machine connected to wifi and set up in La Marzocco's app
Setup
Store your La Marzocco login in the system keyring (macOS Keychain, Windows Credential Locker, or the Secret Service on Linux). Nothing is written to disk:
uvx lamarzocco-mcp setupIt signs in, lists your machines and saves the one to use. Run it again to change account, or
uvx lamarzocco-mcp setup --delete to remove everything. On macOS, the first time the server reads
the keychain you may be asked to allow it; choose "Always Allow".
Use with Claude
The server runs over stdio: your MCP client starts it when needed, so there is nothing to keep running.
Claude Code:
claude mcp add --scope user lamarzocco -- uvx lamarzocco-mcpClaude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS),
then restart Claude Desktop:
{
"mcpServers": {
"lamarzocco": {
"command": "uvx",
"args": ["lamarzocco-mcp"]
}
}
}If Claude Desktop cannot find uvx, use its full path (which uvx, e.g.
/opt/homebrew/bin/uvx).
Tools
Read-only by default. Each tool wraps one method of pylamarzocco's LaMarzoccoCloudClient.
Tool | Returns |
| Machines on the account |
| On/standby, boilers, pre-brewing, back flush |
| Firmware, wifi signal, plumb-in, auto-update |
| Statistics widgets from the app |
| Firmware update status |
| Smart standby and wake-up/sleep schedules |
| Total coffees and flushes |
| Latest 15 shots: time, extraction (pump) seconds, dose, temperature |
| Coffees and flushes per day, up to 30 days |
Responses are La Marzocco's raw JSON with three changes: timestamps become ISO 8601 in local time, the Bluetooth token and wifi name are redacted, and image/tutorial URLs are dropped.
Shot times (extractionSeconds) are pump time measured by the machine, usually a few seconds
shorter than a scale's timer.
Optional write tools
Off by default. With LAMARZOCCO_MCP_ALLOW_WRITE=1 in the server's environment, seven more tools
are registered:
Tool | Changes |
| On (brewing mode) or standby |
| Steam boiler on/off |
| Steam level 1–3 (level-based machines such as the Linea Micra) |
| Coffee boiler target, °C |
| Pre-brewing on/off (or pre-infusion, where the machine has it) |
| Pre-brewing seconds in and out |
| Automatic standby after N minutes |
Each request is checked against the limits the machine reports before it is sent, and the setting is read back afterwards. Back flush, plumb-in, firmware updates and schedules are not exposed.
To enable them in Claude Desktop, add an env block to the server entry:
"lamarzocco": {
"command": "uvx",
"args": ["lamarzocco-mcp"],
"env": { "LAMARZOCCO_MCP_ALLOW_WRITE": "1" }
}In Claude Code: claude mcp add --scope user -e LAMARZOCCO_MCP_ALLOW_WRITE=1 lamarzocco -- uvx lamarzocco-mcp.
Configuration
Variable | Effect |
| Registers the write tools |
| Use this machine instead of the one chosen in |
| JSON file with |
With several machines on the account, tools also take an optional serial_number.
Remote access (optional)
pip install 'lamarzocco-mcp[remote]' adds lamarzocco-mcp serve --http: Streamable HTTP at
/mcp behind single-user OAuth 2.1 (password + TOTP, PKCE, short-lived rotating tokens) from
mcp-owner-auth, so the server can be added as a
custom connector in claude.ai and used from the Claude mobile app. Self-hosted and single-user
only. A Dockerfile is included.
Variable / command | Effect |
| public base URL, e.g. |
| where |
| e.g. |
| username, password and TOTP; prints the OAuth client ID and secret once |
| revokes every token immediately |
Remote access is read-only: serve --http refuses to start with
LAMARZOCCO_MCP_ALLOW_WRITE=1 unless LAMARZOCCO_MCP_ALLOW_REMOTE_WRITE=1 is also set.
Security
Your login and installation key are stored only in the system keyring (or, for a server, in the file
LAMARZOCCO_CREDENTIALS_FILEpoints to).By default the server runs only locally over stdio; there is no network listener. Remote access is opt-in (see above).
Read-only unless you enable write tools.
The server uses La Marzocco's undocumented cloud API through pylamarzocco, the same API their app uses. It can stop working if La Marzocco changes it.
Contributing
Have a different La Marzocco model? Mapping what it returns takes about ten minutes; see CONTRIBUTING.md.
Credits
pylamarzocco by Josef Zweck (MIT)
License
MIT
Available Tools
9 toolsget_coffee_and_flush_counterBRead-only
Total number of coffees and flushes the machine has made.
Inputs: serial_number. Returns: object
get_coffee_and_flush_trendARead-only
Coffees and flushes per day for the last N days, in the user's local timezone.
Inputs: days, serial_number. Returns: object
get_firmware_statusBRead-only
Firmware update status (whether the machine is up to date or updating).
Inputs: serial_number. Returns: object
get_last_coffeesARead-only
The machine's most recent shots, newest first (La Marzocco keeps the latest 15).
Each shot has its end time, extractionSeconds, dose mode, target temperature and whether La Marzocco considers it valid. extractionSeconds is pump time measured by the machine, not a scale timer, so it is usually a few seconds shorter than a scale shows.
Inputs: limit, serial_number. Returns: object
get_machine_settingsCRead-only
Machine settings: firmware versions, wifi signal, plumb-in, auto-update.
Inputs: serial_number. Returns: object
get_machine_statusARead-only
Current machine status: on or standby, coffee and steam boiler state and targets, pre-brewing, and back flush. From the dashboard in La Marzocco's app.
Inputs: serial_number. Returns: object
get_scheduleCRead-only
Smart standby, wake-up/sleep schedules and early start settings.
Inputs: serial_number. Returns: object
get_statisticsCRead-only
The statistics widgets selected in La Marzocco's app, e.g. the last coffees and the total coffee and flush counters.
Inputs: serial_number. Returns: object
list_machinesARead-only
List the La Marzocco machines on the account: model, name, serial number, online state.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools target distinct aspects of a machine, but get_statistics overlaps materially with get_coffee_and_flush_counter, get_last_coffees, and get_coffee_and_flush_trend by potentially returning the same counters or recent shots. get_firmware_status also overlaps somewhat with get_machine_settings, which includes firmware versions. Descriptions help, but an agent could still choose the wrong tool for a simple counter or recent-shot request.
All tool names consistently use snake_case with a clear get_ or list_ verb prefix followed by a specific resource. The convention is predictable throughout the set.
Nine tools is well-scoped for a machine-monitoring server. Each tool maps to a specific dashboard area or data view without excessive granularity.
The read-only monitoring surface is broad: machines, status, settings, firmware, schedules, counters, recent shots, and trends are all covered. Missing control actions such as changing schedules or firmware updates are noticeable, but may be intentionally outside the API's scope.
Maintenance
Related MCP Connectors
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Machine Context Protocol server that enables Claude AI to interact with tools through a structured communication interface, following standard MCP patterns with server initialization and stdio transport.2,530 npm2MIT
- AlicenseAqualityDmaintenanceA local MCP server that exposes macOS automation actions (AppleScript + CLIs) as tools, enabling MCP clients on your Mac to control apps, system settings, and more.39MIT
- FlicenseNot gradedqualityAmaintenanceExposes a governed suite of 38 tools over a single OAuth-gated MCP endpoint, letting web AI chat clients such as Claude, ChatGPT, and Grok operate on a local machine — reading and editing files, running whitelisted shell commands, searching, querying SQLite, driving browsers and DevTools, managing background jobs, ports, and clipboard. Local IDEs and Postman can also connect directly over localhost for offline, low-latency access.-
- AlicenseNot gradedqualityAmaintenanceEnables MCP-compatible clients to manage, run, and interact with local or cloud LLM models through exposed tools for listing, pulling, generating, chatting, embeddings, and web search/fetch. Supports Claude Desktop, Cline, and hybrid local/cloud setups.812 npmAGPL 3.0