Cook (Cooklang recipes)
Read, validate and write Cooklang recipes, plan meals and build shopping lists locally
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.2.3
- Listing updated
- 1 day ago
About Cook (Cooklang recipes)
Cook (Cooklang recipes) is an open-source MCP server for food and drink. It runs locally on your machine and is started by your AI client.
Cook MCP treats a folder of plain .cook and .menu files as the source of truth. The agent reads and searches recipes, validates files and whole collections for errors and broken references, scales servings, writes new recipes and meal plans (validated before saving), builds shopping lists grouped by aisle minus what is in the pantry, tracks stock and expiry, and renders reports. All of that runs on your machine over stdio with no account.
Nutrition and recipe import from photos or social-video links need a cook.md login with Cook Basic (€4.99 a month after a 7-day trial) or Pro. Nutrition currently matches ingredients written in English only. The code is MIT licensed, and the repository also ships 14 skills for tasks such as importing, meal planning and nutrition goals.
It installs from npm as @cookmd/mcp and needs Node.js. Builds exist for macOS (arm64, x64) and Linux; there are no Windows builds yet. The recipe folder comes from COOK_RECIPES_DIR, the client's workspace, or the working directory.
Install
Run in a terminal
claude mcp add cook-mcp -- npx -y @cookmd/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"cook-mcp": {
"command": "npx",
"args": [
"-y",
"@cookmd/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cook-mcp": {
"command": "npx",
"args": [
"-y",
"@cookmd/mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"cook-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cookmd/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cook-mcp": {
"command": "npx",
"args": [
"-y",
"@cookmd/mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cook-mcp": {
"command": "npx",
"args": [
"-y",
"@cookmd/mcp"
]
}
}
}Configuration
COOK_RECIPES_DIRRecipe folder. If unset, the client's workspace roots, then the working directory.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- list_recipes
- Lists recipes, meal plans or report templates.
- read_recipe
- Reads a recipe or menu with parsed ingredients, cookware and steps.
- search_recipes
- Searches recipe names and contents, optionally by tag.
- validate
- Checks files or content for errors and broken references.
- write_recipe
- Saves a validated .cook recipe.
- write_menu
- Saves a validated .menu meal plan.
- write_config
- Saves aisle, pantry or report template configuration.
What it does
- Recipe files stay yours
- Recipes remain plain .cook and .menu files in your own folder.
- Validation
- validate checks a file, folder or unsaved text for errors and broken references.
- Search and scaling
- search_recipes and read_recipe find recipes and scale servings.
- Meal plans and lists
- Write .menu plans and build aisle-grouped shopping lists minus the pantry.
- Pantry tracking
- Track stock and expiry, and ask what you can cook from what you have.
- Paid extras
- Nutrition and photo or video imports need a cook.md Basic or Pro login.
Good for
- Check a whole recipe collection for errors
- Plan a week of dinners from recipes you already have
- Generate a shopping list that skips pantry items
- Convert a recipe to Markdown or HTML
- Get nutrition for a recipe (with a paid login)
Pricing
Open source
MIT licence; nutrition and photo import need Cook Basic (EUR 4.99/month) or Pro
Prices change. Check cook.md before you buy.
Cook (Cooklang recipes) FAQ
Is it free?
The local server is free and MIT licensed; nutrition and photo import come with Cook Basic or Pro.
Does it need an account?
Not for the local tools. A cook.md login is needed for nutrition and imports from photos or social links.
Which platforms are supported?
macOS (arm64, x64) and Linux (x64, arm64). There are no Windows builds yet.
Does nutrition work in other languages?
Currently it matches ingredients written in English only.
Is Cook (Cooklang recipes) free?
Yes. Cook (Cooklang recipes) is open source, so you can use and self-host it for free.
How do I add Cook (Cooklang recipes) to Claude Code?
Run this command in your terminal: claude mcp add cook-mcp -- npx -y @cookmd/mcp
What are the best alternatives to Cook (Cooklang recipes)?
The closest alternatives to Cook (Cooklang recipes) are Fast Food Index, Cook with Loopware, O Meu Financeiro, Cellarion and Cellarion Wine Registry.
Alternatives to Cook (Cooklang recipes)

Fast Food Index
MCP serverLive US fast food menu prices, Big Mac index by state and verified price changes
- 6 tools
- Remote
- Free
- Food and drink

Cook with Loopware
MCP serverCalculated recipes for your cookware, guided step by step by your voice assistant
Not checked yet- Remote
- Free
- Food and drink

O Meu Financeiro
MCP serverAsk about a Brazilian restaurant's sales, bills, balances and DRE, and log expenses
Not checked yet- Remote
- Free trial
- Finance and payments

Cellarion
MCP serverLocal stdio bridge that lets Claude Desktop or Cursor query your Cellarion wine cellar
Not checked yet- Remote
- Open source
- Food and drink

Cellarion Wine Registry
MCP serverPublic MCP endpoint for searching wines, grapes, regions and appellations, no account
- 6 tools
- Remote
- Free
- Food and drink

MyGroceryPal
MCP serverCompare UK supermarket prices for items, baskets and lists from ChatGPT or Claude
- 11 tools
- Remote
- Free
- E-commerce