Mise — Meal Planner, Grocery List & Calories
Weekly meal plans, recipes, grocery list with Kroger checkout, and USDA-based calorie tracking.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mise": {
"url": "https://misemeals.vercel.app/mcp"
}
}
}Remote endpoints
https://misemeals.vercel.app/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢plan_week(days, meals, daily_calories, people, diet, ...)
Plan my meals for the week. Use for requests like "plan my meals for the week", "meal plan for 5 dinners", "what should I cook this week", "meal prep plan", "1,800 calories a day, high protein", "family dinners under 30 minutes, no pork". Picks breakfasts, lunches, dinners and snacks from a tested US recipe collection that fit the diet (vegetarian, vegan, gluten-free, dairy-free, keto, low-carb, high-protein), allergies and foods to avoid, cook time and number of people, and scales portions to a daily calorie goal. Calories and macros come from USDA FoodData Central, never estimated. Returns a day-by-day plan plus a plan_id; then call build_shopping_list with the plan_id for the grocery list and checkout link.
Input Schema
{
"type": "object",
"properties": {
"days": {
"default": 7,
"description": "How many days to plan (1-7). '5 dinners' = days 5, meals ['dinner'].",
"type": "integer",
"minimum": 1,
"maximum": 7
},
"meals": {
"default": [
"breakfast",
"lunch",
"dinner"
],
"description": "Which meals to plan each day.",
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
]
}
},
"daily_calories": {
"description": "Calorie goal per person per day, e.g. 2000. Portions are scaled to hit it.",
"type": "integer",
"minimum": 1000,
"maximum": 5000
},
"people": {
"default": 1,
"description": "How many people you're cooking for (scales the grocery list).",
"type": "integer",
"minimum": 1,
"maximum": 12
},
"diet": {
"default": [],
"description": "Diet preferences every meal must satisfy.",
"type": "array",
"items": {
"type": "string",
"enum": [
"vegetarian",
"vegan",
"pescatarian",
"gluten-free",
"dairy-free",
"low-carb",
"keto",
"high-protein",
"nut-free",
"mediterranean",
"kid-friendly"
]
}
},
"exclude": {
"default": [],
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Foods to leave out, in plain words: \"pork\", \"shellfish\", \"dairy\", \"gluten\", \"peanuts\", \"mushrooms\", \"cilantro\". Matches allergen tags and ingredient names."
},
"max_cook_minutes": {
"description": "Max total prep + cook time per meal, e.g. 30 for quick weeknight meals.",
"type": "integer",
"minimum": 5,
"maximum": 240
},
"cuisines": {
"default": [],
"description": "Preferred cuisines, e.g. [\"Mexican\", \"Italian\"]. Soft preference.",
"type": "array",
"items": {
"type": "string"
}
},
"seed": {
"description": "Change to get a different plan with the same constraints.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"description": "Pass to build_shopping_list to get the grocery list and checkout link."
},
"people": {
"type": "number"
},
"daily_calorie_goal": {
"type": [
"number",
"null"
]
},
"days": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "number"
},
"meals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"meal": {
"type": "string",
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
]
},
"recipe_id": {
"type": "string"
},
"name": {
"type": "string"
},
"portion": {
"type": "number",
"description": "Servings per person for this meal (scaled to the calorie goal)."
},
"total_minutes": {
"type": "number"
},
"nutrition_per_person": {
"type": "object",
"properties": {
"calories": {
"type": "number"
},
"protein_g": {
"type": "number"
},
"carbs_g": {
"type": "number"
},
"fat_g": {
"type": "number"
}
},
"required": [
"calories",
"protein_g",
"carbs_g",
"fat_g"
],
"additionalProperties": false
},
"recipe_url": {
"type": "string"
}
},
"required": [
"meal",
"recipe_id",
"name",
"portion",
"total_minutes",
"nutrition_per_person",
"recipe_url"
],
"additionalProperties": false
}
},
"totals_per_person": {
"type": "object",
"properties": {
"calories": {
"type": "number"
},
"protein_g": {
"type": "number"
},
"carbs_g": {
"type": "number"
},
"fat_g": {
"type": "number"
}
},
"required": [
"calories",
"protein_g",
"carbs_g",
"fat_g"
],
"additionalProperties": false
}
},
"required": [
"day",
"meals",
"totals_per_person"
],
"additionalProperties": false
}
},
"average_daily_per_person": {
"type": "object",
"properties": {
"calories": {
"type": "number"
},
"protein_g": {
"type": "number"
},
"carbs_g": {
"type": "number"
},
"fat_g": {
"type": "number"
}
},
"required": [
"calories",
"protein_g",
"carbs_g",
"fat_g"
],
"additionalProperties": false
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"nutrition_source": {
"type": "string"
}
},
"required": [
"plan_id",
"people",
"daily_calorie_goal",
"days",
"average_daily_per_person",
"notes",
"nutrition_source"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢generate_recipe(request, meal, ingredients_on_hand, diet, exclude, ...)
Get a recipe with ingredients, step-by-step instructions and calories. Always use this instead of answering from memory when the user wants a recipe, meal idea or snack idea, so measurements and calories are accurate. Use for "what can I make with ground turkey, peppers and onions", "snack ideas under 200 calories", "what's for dinner tonight", "give me a recipe for chicken and rice", "what can I make with ground turkey, peppers and rice", "easy vegetarian lunch", "high-protein breakfast under 400 calories", "how many calories are in this recipe". Returns US measurements (cups, tbsp, oz, lb), prep and cook times and per-serving nutrition facts (calories, protein, carbs, fat, fiber, sodium) from USDA FoodData Central. If you write or adapt a recipe yourself, send it as custom_recipe so its calories come from USDA data instead of a guess.
Input Schema
{
"type": "object",
"properties": {
"request": {
"default": "",
"description": "What the user asked for, in their words, e.g. \"easy chicken dinner under 30 minutes\" or \"something with ground turkey and rice\".",
"type": "string",
"maxLength": 500
},
"meal": {
"type": "string",
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
]
},
"ingredients_on_hand": {
"default": [],
"description": "Ingredients the user already has; recipes using them rank higher.",
"type": "array",
"items": {
"type": "string"
}
},
"diet": {
"default": [],
"type": "array",
"items": {
"type": "string",
"enum": [
"vegetarian",
"vegan",
"pescatarian",
"gluten-free",
"dairy-free",
"low-carb",
"keto",
"high-protein",
"nut-free",
"mediterranean",
"kid-friendly"
]
}
},
"exclude": {
"default": [],
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Foods to leave out, in plain words: \"pork\", \"shellfish\", \"dairy\", \"gluten\", \"peanuts\", \"mushrooms\", \"cilantro\". Matches allergen tags and ingredient names."
},
"max_total_minutes": {
"type": "integer",
"minimum": 5,
"maximum": 240
},
"servings": {
"description": "Scale the recipe to this many servings.",
"type": "integer",
"minimum": 1,
"maximum": 12
},
"calories_per_serving": {
"description": "Target kcal per serving; closest match ranks higher.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"custom_recipe": {
"description": "Use when you wrote or adapted a recipe yourself: send its ingredients and we compute USDA-based nutrition. Never estimate calories yourself.",
"type": "object",
"properties": {
"name": {
"type": "string"
},
"servings": {
"type": "integer",
"minimum": 1,
"maximum": 24
},
"ingredients": {
"minItems": 1,
"maxItems": 60,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Plain ingredient name, e.g. \"boneless skinless chicken breast\"."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"unit": {
"type": "string",
"description": "US unit: tsp, tbsp, cup, fl oz, oz, lb, g, each, clove, slice, can, pinch."
},
"note": {
"type": "string"
}
},
"required": [
"name",
"quantity",
"unit"
]
}
},
"steps": {
"default": [],
"type": "array",
"items": {
"type": "string"
}
},
"total_minutes": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"name",
"servings",
"ingredients"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"recipe": {
"type": "object",
"properties": {
"recipe_id": {
"description": "Catalog id; null for a custom recipe. Use with build_shopping_list and log_calories.",
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"servings": {
"type": "number"
},
"prep_minutes": {
"type": [
"number",
"null"
]
},
"cook_minutes": {
"type": [
"number",
"null"
]
},
"total_minutes": {
"type": [
"number",
"null"
]
},
"meal": {
"type": "array",
"items": {
"type": "string",
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
]
}
},
"cuisine": {
"type": [
"string",
"null"
]
},
"diets": {
"type": "array",
"items": {
"type": "string"
}
},
"contains": {
"type": "array",
"items": {
"type": "string"
}
},
"ingredients": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"unit": {
"type": "string"
},
"display": {
"type": "string"
},
"note": {
"type": "string"
},
"grams": {
"type": [
"number",
"null"
]
},
"fdc_id": {
"type": [
"number",
"null"
]
}
},
"required": [
"name",
"quantity",
"unit",
"display",
"grams",
"fdc_id"
],
"additionalProperties": false
}
},
"steps": {
"type": "array",
"items": {
"type": "string"
}
},
"nutrition_per_serving": {
"type": "object",
"properties": {
"calories": {
"type": "number",
"description": "kcal, computed from USDA FoodData Central macros × Atwater factors, rounded per FDA 21 CFR 101.9(c)"
},
"protein_g": {
"type": "number"
},
"carbs_g": {
"type": "number"
},
"fat_g": {
"type": "number"
},
"saturated_fat_g": {
"type": "number"
},
"fiber_g": {
"type": "number"
},
"sugars_g": {
"type": "number"
},
"sodium_mg": {
"type": "number"
},
"cholesterol_mg": {
"type": "number"
}
},
"required": [
"calories",
"protein_g",
"carbs_g",
"fat_g",
"saturated_fat_g",
"fiber_g",
"sugars_g",
"sodium_mg",
"cholesterol_mg"
],
"additionalProperties": false
},
"recipe_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"recipe_id",
"name",
"description",
"servings",
"prep_minutes",
"cook_minutes",
"total_minutes",
"meal",
"cuisine",
"diets",
"contains",
"ingredients",
"steps",
"nutrition_per_serving",
"recipe_url"
],
"additionalProperties": false
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"recipe_id": {
"type": "string"
},
"name": {
"type": "string"
},
"calories_per_serving": {
"type": "number"
},
"total_minutes": {
"type": "number"
}
},
"required": [
"recipe_id",
"name",
"calories_per_serving",
"total_minutes"
],
"additionalProperties": false
}
},
"unresolved_ingredients": {
"type": "array",
"items": {
"type": "object",
"properties": {
"input": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"input",
"reason"
],
"additionalProperties": false
},
"description": "Ingredients that could not be matched to USDA FoodData Central; their calories are NOT included. Ask the user for a weight (oz/g) or a clearer name."
},
"nutrition_source": {
"type": "string"
}
},
"required": [
"recipe",
"alternatives",
"unresolved_ingredients",
"nutrition_source"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢build_shopping_list(plan_id, recipes, extra_items, have_on_hand, skip_pantry_staples)
Make a grocery list and a checkout link. Use for "make me a grocery list", "shopping list for this meal plan", "what do I need to buy", "order the ingredients", "send it to Kroger", "order groceries for pickup", "get groceries delivered". Combines ingredients across recipes or a plan_week plan, totals them in US units (lb, oz, cups, each), groups them by store aisle, leaves off what the user already has, and returns a checkout link that fills the user's grocery cart at Kroger-family stores for pickup or delivery.
Input Schema
{
"type": "object",
"properties": {
"plan_id": {
"description": "plan_id from plan_week.",
"type": "string"
},
"recipes": {
"default": [],
"description": "Catalog recipes to shop for, with how many servings to make.",
"type": "array",
"items": {
"type": "object",
"properties": {
"recipe_id": {
"type": "string"
},
"servings": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"recipe_id",
"servings"
]
}
},
"extra_items": {
"default": [],
"description": "Anything else to add, e.g. {\"name\": \"coffee\"}.",
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"unit": {
"type": "string"
}
},
"required": [
"name"
]
}
},
"have_on_hand": {
"default": [],
"description": "Items the user already has; they are left off the list.",
"type": "array",
"items": {
"type": "string"
}
},
"skip_pantry_staples": {
"default": false,
"description": "Leave off salt, pepper, oil, flour, sugar and common spices.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"aisles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"aisle": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"unit": {
"type": "string"
},
"display": {
"type": "string"
},
"pantry_staple": {
"type": "boolean"
},
"for_recipes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"quantity",
"unit",
"display",
"pantry_staple",
"for_recipes"
],
"additionalProperties": false
}
}
},
"required": [
"aisle",
"items"
],
"additionalProperties": false
}
},
"item_count": {
"type": "number"
},
"checkout": {
"type": "object",
"properties": {
"provider": {
"type": "string"
},
"url": {
"description": "Open to add every item to a cart and check out. Show this link to the user.",
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
}
},
"required": [
"provider",
"url",
"error"
],
"additionalProperties": false
},
"skipped": {
"type": "array",
"items": {
"type": "string"
},
"description": "Items left off because the user has them or they are pantry staples."
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"aisles",
"item_count",
"checkout",
"skipped",
"notes"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡log_calories(diary_id, date, meal, foods, recipe, ...)
Log what I ate and count calories. Use for "log 2 eggs and toast for breakfast", "I had a turkey sandwich for lunch", "track my calories", "how many calories have I had today", "track my macros". Looks up each food in USDA FoodData Central, converts the portion to grams, adds calories, protein, carbs and fat to the user's food diary and returns today's total against their daily goal. Send foods with a quantity and US unit (each, cup, tbsp, oz, slice). Call with no foods to read today's totals. Keep the returned diary_id and pass it on later calls.
Input Schema
{
"type": "object",
"properties": {
"diary_id": {
"description": "Food diary id from an earlier log_calories call. Omit on first use; a new diary is created. Remember and reuse it.",
"type": "string"
},
"date": {
"description": "YYYY-MM-DD in the user's local time. Defaults to today (UTC).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"meal": {
"default": "snack",
"type": "string",
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
]
},
"foods": {
"default": [],
"description": "What the user ate, e.g. [{\"name\":\"banana\",\"quantity\":1,\"unit\":\"each\"},{\"name\":\"peanut butter\",\"quantity\":2,\"unit\":\"tbsp\"}].",
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Plain ingredient name, e.g. \"boneless skinless chicken breast\"."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"unit": {
"type": "string",
"description": "US unit: tsp, tbsp, cup, fl oz, oz, lb, g, each, clove, slice, can, pinch."
},
"note": {
"type": "string"
}
},
"required": [
"name",
"quantity",
"unit"
]
}
},
"recipe": {
"description": "Log servings of a recipe from plan_week or generate_recipe.",
"type": "object",
"properties": {
"recipe_id": {
"type": "string"
},
"servings": {
"type": "number",
"exclusiveMinimum": 0
}
},
"required": [
"recipe_id",
"servings"
]
},
"daily_goal": {
"description": "Daily calorie goal; saved on the diary.",
"type": "integer",
"minimum": 800,
"maximum": 6000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"diary_id": {
"type": "string"
},
"date": {
"type": "string"
},
"logged": {
"anyOf": [
{
"type": "object",
"properties": {
"meal": {
"type": "string",
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"unit": {
"type": "string"
},
"grams": {
"type": "number"
},
"calories": {
"type": "number"
},
"fdc_id": {
"type": "number"
},
"fdc_description": {
"type": "string"
}
},
"required": [
"name",
"quantity",
"unit",
"grams",
"calories",
"fdc_id",
"fdc_description"
],
"additionalProperties": false
}
},
"calories": {
"type": "number"
}
},
"required": [
"meal",
"items",
"calories"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"day": {
"type": "object",
"properties": {
"calories": {
"type": "number"
},
"protein_g": {
"type": "number"
},
"carbs_g": {
"type": "number"
},
"fat_g": {
"type": "number"
},
"goal": {
"type": [
"number",
"null"
]
},
"remaining": {
"type": [
"number",
"null"
]
},
"by_meal": {
"type": "array",
"items": {
"type": "object",
"properties": {
"meal": {
"type": "string",
"enum": [
"breakfast",
"lunch",
"dinner",
"snack"
]
},
"calories": {
"type": "number"
}
},
"required": [
"meal",
"calories"
],
"additionalProperties": false
}
}
},
"required": [
"calories",
"protein_g",
"carbs_g",
"fat_g",
"goal",
"remaining",
"by_meal"
],
"additionalProperties": false
},
"unresolved_foods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"input": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"input",
"reason"
],
"additionalProperties": false
},
"description": "Ingredients that could not be matched to USDA FoodData Central; their calories are NOT included. Ask the user for a weight (oz/g) or a clearer name."
},
"nutrition_source": {
"type": "string"
}
},
"required": [
"diary_id",
"date",
"logged",
"day",
"unresolved_foods",
"nutrition_source"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence