MCP Marmiton

mcp-marmiton

Marmiton is the largest French cooking site, where home cooks have been publishing their recipes since 1999. Each one gives its ingredients with their quantities, the steps to follow, the preparation and cooking times, the number of servings it is written for, and the ratings the people who made it left behind.

This server connects a chat client to that site. You can search its recipes by dish or by ingredient, read one in full with its ingredients and its steps, and rescale the quantities to the number of people at your table, with each line saying whether the figure is exact or was moved to stay usable in a kitchen. It needs no API key and no account.

_Version française_

Install

One-click install

Claude Code

claude mcp add marmiton -- npx -y mcp-marmiton

Claude Desktop, Cursor, and any client using the standard config format

{

"mcpServers": { "marmiton": { "command": "npx", "args": ["-y", "mcp-marmiton"] } } }

Node 24 or later is required, and no environment variable has to be set.

With Docker

{

"mcpServers": { "marmiton": { "command": "docker", "args": ["run", "-i", "--rm", "ghcr.io/smeet666/mcp-marmiton:2.2.0"] } } }

-i keeps stdin open, which is where the protocol travels, and -t is left out because a TTY rewrites the stream. The container needs outbound HTTPS to www.marmiton.org, and nothing else: no volume, no port, no credential.

Bundle, without npm

Download mcp-marmiton-2.2.0.mcpb from the latest release and open it. A client that supports MCP bundles installs it on its own, with no npm and no configuration file to edit. The bundle carries its dependencies, so nothing is fetched at install time.

What you can ask

• « Trouve-moi une recette de tarte aux pommes. »
• "Read me that recipe for six people instead of four."
• "What can I make with courgettes and chèvre?"
• "Here is a recipe I copied from a book, scale it by 1.5 for me."
• "How long does the second one take to cook?"

Marmiton is a French site, so its recipes are found in French: tarte aux pommes, poulet curry coco. The ordinary path runs from a search to a reading: search_recipes names an id, and get_recipe takes that id.

Tools

The server only reads. It publishes nothing to Marmiton.

search_recipes

Searches the recipes for a dish or an ingredient. Marmiton matches on the opening letters of a word, so a query brings back what the site ranked for it, and the answer says when the titles carry none of the words asked for.

In return: rows carrying id, which get_recipe takes; title; url; and image_url, which is null for a recipe published without a picture. Alongside come result_count and total_available, the recipes on this page before limit was applied. Marmiton's robots.txt disallows paging through search results, so one page is what a search reads: narrow the query to see other recipes.

get_recipe

Reads one recipe in full, and rescales its quantities when a number of servings is given.

In return: title, url, ingredients, steps, prep_minutes, cook_minutes, total_minutes, category, author, rating and nutrition, each null when the page publishes none. yield says what the recipe was written for and what it was rescaled to: original_count, original_text, requested, unit for what is being counted, and factor for the multiplier applied. Every ingredient carries original, text, amount, amountMax for a range, unit, and scaling, which reads scaled, rounded or unscaled. The figures are this server's arithmetic, so say they were recomputed when you show them. nutrition describes the recipe as published, at its own number of servings.

scale_ingredients

Applies the same arithmetic to any list of ingredient lines, with no request to the site, so it works on a recipe copied from a book or a family notebook.

Pass factor, or the from_servings and to_servings pair.

In return: the factor used, the rescaled ingredients in the shape get_recipe returns, and scaled_count, rounded_count and unscaled_count, which count the lines whose value the rounding moved.

Scaling the quantities

Every ingredient comes back with a scaling flag saying what the rescaling could do with its quantity.

A quantity is stated in the unit that suits it, so a line can come back in a different unit from the one the recipe used: 200 g multiplied by twenty reads 4 kg.

How finely an ingredient can be divided depends on what it is. A baguette can be cut in two, in three or in four; an egg cannot be shared out. A quantity landing between the two is rounded, and the rescaled recipe then departs a little from the proportions of the original. The line carries rounded, and its note says what was done.

Configuration

Every variable is optional. Set them in the env block of your client config.

A value outside its range falls back to the default, and the reason is written to stderr.

Errors

Every failure carries one of six codes, a message, and where it helps a hint naming the next move.

| not_found | Marmit