Cook (Cooklang recipes) MCP Server

An MCP server that gives your AI agent (Claude Code, Claude Desktop, Cursor, ChatGPT, or any other MCP client) access to your Cooklang recipe collection. Recipes stay as plain .cook and .menu files…

Local serverstdio

What is the Cook (Cooklang recipes) MCP Server?

cook-mcp is an MCP project maintained in the cook-md/cook-mcp repository. The maintainer describes its purpose as “An MCP server that gives your AI agent (Claude Code, Claude Desktop, Cursor, ChatGPT, or any other MCP client) access to your Cooklang recipe collection…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @cookmd/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares COOK_RECIPES_DIR. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_recipesList recipes, meal plans or report templates (kind: recipe, menu, template, all)
read_recipeRead a recipe or menu: source plus parsed ingredients, cookware, steps and metadata; optional scaling
search_recipesSearch names and contents, optionally filtered by tag
validateCheck a file, a folder, the whole collection, or unsaved content for errors and broken references
write_recipeSave a .cook recipe (validated first)
write_menuSave a .menu meal plan (validated first)
write_configSave config/aisle.conf, config/pantry.conf, or a .jinja report template under reports/ or config/reports/
shopping_listBuild a shopping list from recipes and/or menus: merges duplicates, groups by aisle, subtracts the pantry
pantry_listShow the pantry, by section
pantry_expiringItems expiring soon
pantry_depletedItems at or below their low-stock threshold
pantry_recipesWhich recipes you can cook with what is in the pantry
pantry_updateAdd, update or remove pantry items
render_reportRender a jinja report template against a recipe or menu (plain templates need no login)
loginStart a cook.md device login; shows a code and a URL
auth_statusShow login status, plan and import allowance
get_nutritionNutrition facts for one ingredient amount
aggregate_nutritionSum nutrition across many ingredient lines
lookup_ingredientFuzzy-search the ingredient catalog
convert_unitsConvert between units (volume to mass needs a density)
check_categoryCheck whether an ingredient belongs to a category
branded_lookupLook up a packaged product by barcode or text
reference_intakesDaily reference-intake tables (RDA/DV)
import_recipeConvert a web page, photos or pasted text to Cooklang

How to install the Cook (Cooklang recipes) MCP Server

{
  "mcpServers": {
    "cook": {
      "command": "npx",
      "args": [
        "-y",
        "@cookmd/mcp"
      ],
      "env": {
        "COOK_RECIPES_DIR": "/path/to/recipes"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
COOK_RECIPES_DIRDeclared in the maintainer’s client configuration.Check documentation