MCP Marmiton

What mcp-marmiton does

mcp-marmiton exposes Marmiton recipe data through three MCP tools. It can search by a dish, ingredient, or combined free-text query; retrieve a recipe's ingredients and preparation steps; and adjust quantities for a requested number of servings. Recipe results include identifiers and URLs that can be passed to the retrieval tool.

The server also scales ingredient lists independently of Marmiton. This makes it suitable for recipes copied from books, notes, or other sources, provided the ingredient lines are supplied in French. It performs read operations only and does not publish content to Marmiton.

How it works

The usual workflow starts with search_recipes. The tool returns one page of candidates, including titles, IDs, URLs, and image URLs when available. Pass the selected ID to get_recipe, or provide a Marmiton recipe URL directly. The recipe response can include ingredients, steps, preparation and cooking times, category, author, rating, nutrition, and serving information.

get_recipe accepts an optional serving count. Its ingredient results identify whether each quantity was calculated exactly, rounded to remain usable, or left unchanged because no quantity was available. The response also describes the original and requested yield. Nutrition values describe the recipe as published rather than recalculating nutrition for the requested serving count.

For local scaling, provide scale_ingredients with either a multiplier or an original and target serving count. The tool returns the applied factor, adjusted ingredient records, and counts for scaled, rounded, and unscaled lines.

Setup and configuration

Node.js 24 or later is required. The package can be launched with npx:

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

This configuration works with Claude Desktop, Cursor, and clients using the standard MCP configuration format. Claude Code can add the server with claude mcp add marmiton -- npx -y mcp-marmiton. One-click installation options are available for Cursor and VS Code.

Docker and an MCP bundle are also supported. A Docker deployment uses interactive standard input for the MCP protocol and needs outbound HTTPS access to www.marmiton.org; it does not require a volume, port, or credential. No environment variables or API keys are required.

Tools and capabilities

• search_recipes: Search Marmiton using French free text. The query can contain a dish, an ingredient, or both. A limit controls how many results are returned from the single result page.
• get_recipe: Retrieve a recipe by numeric ID or Marmiton URL, optionally recalculating quantities for up to the requested serving limit.
• scale_ingredients: Rescale one to 100 French ingredient lines using a direct factor or serving conversion without making a web request.

Quantity handling accounts for different ingredient types. Masses and volumes are multiplied and rounded to readable values. Countable ingredients may become halves when that is practical, while items such as eggs, yolks, and whites are kept as whole units. Approximate measures retain their vocabulary, and lines without quantities are returned unchanged and flagged.

Limitations and notes

Search terms work best in French because Marmiton is a French site. Search results are limited to one page: the server does not paginate because Marmiton's robots.txt disallows paging through search results. Narrow the query to find different candidates.

Recipe scaling is the server's arithmetic, so applications should identify the quantities as recomputed when presenting them. Check the returned yield when a recipe produces pieces rather than servings. When displaying recipe content to users, include the returned attribution.