recipe-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@recipe-mcpcreate a healthy chicken stir-fry with vegetables"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Install the MCP server:
npm install -g @cookwith/recipe-mcpAdd to your Claude Desktop configuration:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"recipe-mcp": {
"command": "npx",
"args": ["@cookwith/recipe-mcp"],
"env": {
"COOKWITH_API_URL": "https://cookwith.co"
}
}
}
}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 devUsage 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 descriptiondietaryRestrictions(string[], optional) - e.g., ["vegetarian", "gluten-free"]allergies(string[], optional) - Ingredients to avoiddislikes(string[], optional) - Foods to excludecalories(string, optional) - Target calories per servingprotein(string, optional) - Target protein in gramsservings(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 transforminstructions(string, required) - How to modify the recipecalories(string, optional) - New target caloriesprotein(string, optional) - New target proteinservings(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
COOKWITH_API_URL- API endpoint (default: https://cookwith.co)
Custom API Endpoint
For development or self-hosted instances:
export COOKWITH_API_URL=http://localhost:3000
npx @cookwith/recipe-mcpExamples
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
📧 Email: support@blaide.com
Powered By
Cookwith - AI-powered cooking platform
OpenAI GPT-4 - Recipe generation
Model Context Protocol - Tool integration
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that transforms AI assistants into personal chefs by providing recipe recommendations and meal planning features based on the HowToCook repository.Last updated57,349749ISC
- Alicense-qualityAmaintenanceRecipe Finder AI - MCP server providing AI-powered tools and automation by MEOK AI LabsLast updated10MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI-powered recipe generation and transformation using natural language, supporting dietary restrictions, allergies, and nutritional goals.Last updated217MIT
- Alicense-qualityDmaintenanceMCP 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.Last updated61MIT
Related MCP Connectors
MCP server for NanoBanana AI image generation and editing
MCP server for Google Veo AI video generation
MCP server for Wan AI video generation
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/valetdotdev/recipe-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server