Mcp Delonghi Ecam

io.github.daedalusPublished by GitHub account daedalusv0.1.1Updated Oct 24, 2026

MCP server for DeLonghi ECAM espresso coffee machines via local network

VerifiedSTDIODesktop onlyLocation & Lifestyle

Overview

AI-generated overview

A local MCP server that lets an assistant control DeLonghi ECAM espresso machines over the local network: brewing drinks, checking status and adjusting settings

What you can do
Connect to and disconnect from a coffee machine at a local IP address, and read its status, model, serial number and usage statistics. Brew a chosen beverage with size, taste level and temperature, and stop brewing in progress. Turn the machine on or off and control the cup light and cup warmer. List available beverages and look up a beverage's recipe.
When to use it
Worth adding if you own a supported DeLonghi ECAM machine (ECAM 550 series, Dinamica Plus, PrimaDonna Soul or another model with the local LAN API) and want to start drinks or check the machine by voice or chat instead of using the app.
Requirements
Runs locally as a Python package installed with pip; the machine must be on the same local network, reachable over HTTP on port 10280 by default. No accounts, API keys or environment variables are declared.
Before you install
The tools act on physical hardware: brewing, stopping, powering on or off and changing the cup warmer or light have real effects, and a misheard drink order will actually be made. Only use it on a trusted local network, since the machine is reached over plain HTTP with no authentication.

Installation

In SourceWeft

  1. Open Mcp Delonghi Ecam in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-delonghi-ecam

MCP server for DeLonghi ECAM espresso coffee machines via local network control.

[PyPI] [Python] [Ruff]

mcp-name: io.github.daedalus/mcp-delonghi-ecam

Overview

This MCP server provides comprehensive control over DeLonghi ECAM series automatic espresso coffee machines through their local network API. It enables LLMs to interact with the coffee machine for brewing beverages, monitoring status, and managing machine settings.

Supported Machines

  • DeLonghi ECAM 550 series
  • DeLonghi Dinamica Plus
  • DeLonghi PrimaDonna Soul
  • Other ECAM-based machines with local LAN API

Install

bash
pip install mcp-delonghi-ecam

Usage

As MCP Server

Run the server:

bash
mcp-delonghi-ecam

Or programmatically:

python
from mcp_delonghi_ecam import mcp
mcp.run()

Tools Available

ToolDescription
connectConnect to coffee machine at IP address
disconnectDisconnect from the machine
get_statusGet current machine status
brew_beverageBrew a specific beverage
stop_brewingStop current brewing
turn_onTurn machine on
turn_offTurn machine off
set_cup_lightControl cup illumination
set_cup_warmerControl cup warmer
get_machine_infoGet machine serial and model
get_statisticsGet usage statistics
list_beveragesList available beverages
get_recipeGet recipe for a beverage

Example Usage

python
# Connect to machineawait connect("192.168.1.100")
# Get statusstatus = await get_status("markdown")
# Brew espressoresult = await brew_beverage("espresso", 40, "normal", "medium")
# Brew cappuccinoresult = await brew_beverage("cappuccino", 60, "strong", "high")
# Turn on cup warmerawait set_cup_warmer(True)

Configuration

The server connects to the coffee machine on the local network using:

  • Default Port: 10280
  • Protocol: HTTP (local LAN API)

Make sure the coffee machine is connected to the same network as the MCP server.

Development

bash
git clone https://github.com/daedalus/mcp-delonghi-ecam.gitcd mcp-delonghi-ecampip install -e ".[test]"
# Run testspytest
# Formatruff format src/ tests/
# Lintruff check src/ tests/
# Type checkmypy src/

API Reference

Beverage Types

  • espresso, coffee, long_coffee, espresso_2x
  • doppio_plus, americano, cappuccino
  • latte_macchiato, caffe_latte, flat_white
  • espresso_macchiato, hot_milk, hot_water, steam, chocolate

Taste Levels

  • extra_mild, mild, normal, strong, extra_strong

Temperature Settings

  • low, medium, high

License

MIT License - see LICENSE file for details.

Credits

Protocol information based on reverse-engineered specifications from:

  • longshot (Rust implementation)
  • ECAMpy
  • delonghi-coffee-link-python

Source: README.md at commit 7644586

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts