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)

Installation

For Claude Desktop

1. Install the MCP server:

npm install -g @cookwith/recipe-mcp

2. 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"
      }
    }
  }
}

3. 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?: numb

... [View full README on GitHub](https://github.com/blaideinc/recipe-mcp#readme)