MCP Delonghi Ecam logo

MCP Delonghi Ecam

MCP server for DeLonghi ECAM espresso coffee machines via local network

Install MCP Delonghi Ecam

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-delonghi-ecam": {
      "command": "uvx",
      "args": [
        "mcp-delonghi-ecam"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Tools13

What MCP Delonghi Ecam lets your agent do. Expand a tool for its parameters.

Self-reported~114 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

5/5 checks healthy over the last 42d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · mcp-delonghi-ecam (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
Last commit6mo agoMost recent push to the default branch.
Tools exposed13Callable tools this server registers over MCP.

From the project 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

Terminal
pip install mcp-delonghi-ecam

Usage

As MCP Server

Run the server:

bash
mcp-delonghi-ecam

Or programmatically:

server.ts
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 machine
await connect("192.168.1.100")

# Get status
status = await get_status("markdown")

# Brew espresso
result = await brew_beverage("espresso", 40, "normal", "medium")

# Brew cappuccino
result = await brew_beverage("cappuccino", 60, "strong", "high")

# Turn on cup warmer
await 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.git
cd mcp-delonghi-ecam
pip install -e ".[test]"

# Run tests
pytest

# Format
ruff format src/ tests/

# Lint
ruff check src/ tests/

# Type check
mypy 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

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Delonghi Ecam

mcp-delonghi-ecam is an MCP server that connects to compatible DeLonghi ECAM-series automatic espresso machines over their local network. It lets MCP-compatible clients monitor status, brew beverages, manage settings, and retrieve machine information and statistics. It communicates with the machine through its local HTTP API, using port 10280.

Install mcp-delonghi-ecam with `pip install mcp-delonghi-ecam`, then start it by running `mcp-delonghi-ecam`. In Python, import `mcp` from `mcp_delonghi_ecam` and call `mcp.run()`.

Connect to the machine by providing its IP address with the `connect` tool. The machine and MCP server must be on the same local network; the server uses the machine’s local HTTP API on default port 10280.

The server can connect and disconnect, get machine status and information, brew or stop beverages, turn the machine on or off, control cup illumination and the cup warmer, retrieve usage statistics, and list beverages or get beverage recipes.

Supported machines include DeLonghi ECAM 550 series, Dinamica Plus, PrimaDonna Soul, and other ECAM-based machines with a local LAN API. Beverage types include espresso, coffee, long coffee, espresso 2x, doppio+, americano, cappuccino, latte macchiato, caffe latte, flat white, hot milk, hot water, steam, and chocolate.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Delonghi Ecam AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-delonghi-ecam?style=directory)](https://allmcps.com/mcp/mcp-delonghi-ecam)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-delonghi-ecam"><img src="https://allmcps.com/api/badge/mcp-delonghi-ecam?style=directory" alt="MCP Delonghi Ecam on AllMCPs" /></a>