Skip to main content
Glama

Recipe MCP Server

An MCP (Model Context Protocol) server that provides AI-powered recipe generation and transformation tools. Generate personalized recipes based on dietary preferences, transform existing recipes to meet nutritional goals, and more.

Features

  • 🍳 Generate Recipes - Create custom recipes from natural language descriptions

  • 🔄 Transform Recipes - Modify existing recipes (make vegan, adjust calories, etc.)

  • 🥗 Dietary Support - Handle allergies, restrictions, and food preferences

  • 📊 Nutrition Goals - Target specific calorie and protein requirements

  • 🆓 Open Access - No API key required (rate limited)

Related MCP server: Recipe Finder AI MCP

Installation

For Claude Desktop

  1. Install the MCP server:

npm install -g @cookwith/recipe-mcp
  1. Add to your Claude Desktop configuration:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "recipe-mcp": {
      "command": "npx",
      "args": ["@cookwith/recipe-mcp"],
      "env": {
        "COOKWITH_API_URL": "https://cookwith.co"
      }
    }
  }
}
  1. Restart Claude Desktop

For Development

# Clone the repository
git clone https://github.com/cookwith/recipe-mcp.git
cd recipe-mcp

# Install dependencies
npm install

# Run in development mode
npm run dev

Usage Examples

Generate a Recipe

// In Claude Desktop, you can say:
"Generate a healthy Mediterranean pasta dish with lots of vegetables"

// The tool will be called with:
{
  "prompt": "A healthy Mediterranean pasta dish with lots of vegetables",
  "dietaryRestrictions": ["vegetarian"],
  "calories": "450",
  "servings": 4
}

Transform a Recipe

// After generating or providing a recipe:
"Make this recipe vegan and reduce the calories by 200"

// The tool will be called with:
{
  "recipe": { /* existing recipe object */ },
  "instructions": "Make this vegan and reduce calories by 200",
  "calories": "350"
}

Tools

generate_recipe

Generate a new recipe based on natural language instructions.

Parameters:

  • prompt (string, required) - Natural language description

  • dietaryRestrictions (string[], optional) - e.g., ["vegetarian", "gluten-free"]

  • allergies (string[], optional) - Ingredients to avoid

  • dislikes (string[], optional) - Foods to exclude

  • calories (string, optional) - Target calories per serving

  • protein (string, optional) - Target protein in grams

  • servings (number, optional) - Number of servings (1-20, default: 4)

transform_recipe

Transform an existing recipe based on instructions.

Parameters:

  • recipe (object, required) - The recipe to transform

  • instructions (string, required) - How to modify the recipe

  • calories (string, optional) - New target calories

  • protein (string, optional) - New target protein

  • servings (number, optional) - New number of servings

Rate Limits

The public API has the following rate limits:

  • Anonymous Access: 20 requests per hour per IP address

  • No authentication required

  • Retry-After header provided when limit exceeded

Recipe Object Format

interface Recipe {
  title: string;
  description: string;
  ingredients: string[];      // e.g., ["2 cups flour", "1 tsp salt"]
  instructions: string[];      // Step-by-step instructions
  servings: number;
  prepTime?: number;          // Minutes
  cookTime?: number;          // Minutes
  totalTime?: number;         // Minutes
  cuisine?: string;           // e.g., "Italian", "Mexican"
  course?: string;            // e.g., "main", "dessert"
  difficulty?: string;        // e.g., "easy", "medium", "hard"
  calories?: number;          // Per serving
  protein?: number;           // Grams per serving
  carbs?: number;            // Grams per serving
  fat?: number;              // Grams per serving
  fiber?: number;            // Grams per serving
  sugar?: number;            // Grams per serving
  sodium?: number;           // Milligrams per serving
}

Configuration

Environment Variables

Custom API Endpoint

For development or self-hosted instances:

export COOKWITH_API_URL=http://localhost:3000
npx @cookwith/recipe-mcp

Examples

Basic Recipe Generation

// Request
{
  "prompt": "Quick and easy chicken stir-fry"
}

// Response
{
  "title": "Quick Chicken Stir-Fry",
  "description": "A delicious and speedy chicken stir-fry...",
  "ingredients": [
    "2 chicken breasts, sliced",
    "2 cups mixed vegetables",
    "3 tbsp soy sauce",
    // ...
  ],
  "instructions": [
    "Heat oil in a large wok or skillet",
    "Add chicken and cook until golden",
    // ...
  ],
  "servings": 4,
  "prepTime": 10,
  "cookTime": 15,
  "calories": 320,
  "protein": 28
}

Recipe Transformation

// Request
{
  "recipe": {
    "title": "Classic Beef Lasagna",
    "ingredients": ["1 lb ground beef", "ricotta cheese", ...],
    // ... full recipe
  },
  "instructions": "Make this vegetarian and lower in calories"
}

// Response
{
  "title": "Vegetarian Light Lasagna",
  "description": "A healthier vegetarian version...",
  "ingredients": [
    "2 cups chopped mushrooms",
    "1 cup low-fat ricotta",
    // ... transformed ingredients
  ],
  // ... rest of transformed recipe
}

Troubleshooting

Rate Limit Errors

If you receive a 429 error, you've exceeded the rate limit. Wait for the time specified in the retryAfter field before making another request.

Connection Issues

Ensure your internet connection is stable and the API endpoint is accessible.

Invalid Parameters

Check that your parameters match the expected format and constraints (e.g., servings between 1-20).

Contributing

Contributions are welcome! Please see our Contributing Guide for details.

License

MIT License - see LICENSE file for details.

Support

Powered By

Available Tools

2 tools
generate_recipeA

Generate a new recipe based on natural language instructions and dietary preferences

Inputs: prompt (required), protein, calories, dislikes, +3 more.

transform_recipeB

Transform an existing recipe based on instructions (e.g., make it vegan, adjust calories, change servings)

Inputs: recipe (required), instructions (required), protein, calories, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 2 tools

    Disambiguation5/5

    generate_recipe creates a new recipe, while transform_recipe modifies an existing one. The semantic boundary is clear, with no overlap in purpose.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern: generate_recipe and transform_recipe. The verbs are distinct and the object is uniform.

    Tool Count3/5

    With only two tools, the server feels thin for a recipe domain. While the scope could be narrowly focused on generation, the count is borderline.

    Completeness2/5

    transform_recipe requires an existing recipe, but there is no tool to retrieve or list recipes. This is a significant gap that leaves agents unable to obtain the input needed for transformation.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that transforms AI assistants into personal chefs by providing recipe recommendations and meal planning features based on the HowToCook repository.
      5
      807
      ISC
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that enables AI-powered recipe generation and transformation using natural language, supporting dietary restrictions, allergies, and nutritional goals.
      2
      13 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for MealMastery AI meal planning that enables users to manage meal plans, recipes, and grocery lists through natural language conversation with AI agents like Claude.
      52 npm
      MIT