Skip to content
MCP server

Cook (Cooklang recipes)

Read, validate and write Cooklang recipes, plan meals and build shopping lists locally

Runs locallyStatus and history
Install
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/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cookmd/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cookmd/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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)

  1. Fast Food Index

    MCP server

    Live US fast food menu prices, Big Mac index by state and verified price changes

    • 6 tools
    • Remote
    • Free
    • Food and drink
  2. Calculated recipes for your cookware, guided step by step by your voice assistant

    Not checked yet
    • Remote
    • Free
    • Food and drink
  3. Ask about a Brazilian restaurant's sales, bills, balances and DRE, and log expenses

    Not checked yet
    • Remote
    • Free trial
    • Finance and payments
  4. Cellarion

    MCP server

    Local stdio bridge that lets Claude Desktop or Cursor query your Cellarion wine cellar

    Not checked yet
    • Remote
    • Open source
    • Food and drink
  5. Public MCP endpoint for searching wines, grapes, regions and appellations, no account

    • 6 tools
    • Remote
    • Free
    • Food and drink
  6. MyGroceryPal

    MCP server

    Compare UK supermarket prices for items, baskets and lists from ChatGPT or Claude

    • 11 tools
    • Remote
    • Free
    • E-commerce