# Cook (Cooklang recipes)

> Cook (Cooklang recipes) is an open-source MCP server for food and drink. Read, validate and write Cooklang recipes, plan meals and build shopping lists locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux
- **Website:** https://cook.md/help/mcp
- **Repository:** https://github.com/cook-md/cook-mcp
- **MCP Registry name:** io.github.cook-md/cook-mcp
- **Categories:** food and drink
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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)

## Install

### Claude Code (Terminal)

```sh
claude mcp add cook-mcp -- npx -y @cookmd/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cookmd/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cookmd/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cook-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cookmd/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cookmd/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cookmd/mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [Fast Food Index](https://ai-powered.com/mcp/fast-food-index): Fast Food Index is a free MCP server for food and drink.
- [Cook with Loopware](https://ai-powered.com/mcp/cook-with-loopware): Cook with Loopware is a free MCP server for food and drink.
- [O Meu Financeiro](https://ai-powered.com/mcp/o-meu-financeiro): O Meu Financeiro is an MCP server for finance and payments.
- [Cellarion](https://ai-powered.com/mcp/cellarion): Cellarion is an open-source MCP server for food and drink.
- [Cellarion Wine Registry](https://ai-powered.com/mcp/cellarion-wine-registry): Cellarion Wine Registry is a free MCP server for food and drink.
- [MyGroceryPal](https://ai-powered.com/mcp/mygrocerypal): MyGroceryPal is a free MCP server for e-commerce.
- [Dishes of London](https://ai-powered.com/mcp/dishes-of-london): Dishes of London is a free MCP server for food and drink.
- [ChefSums](https://ai-powered.com/mcp/chefsums): ChefSums is a freemium MCP server for food and drink.

---
Source: https://ai-powered.com/mcp/cook-cooklang-recipes
