Recipes

Fetch one saved recipe's full detail (ingredients and steps).

Search saved recipes by text, course, or favorite. Rows are compact summaries (title, cuisine, tags, time, rating); fetch one full recipe with recipes_getRecipe when the user needs ingredients, steps, or notes. Use this to resolve a recipeId before a write.

Return the recipes cockpit: this week's meal plan and recently added recipes. Recipe rows are compact summaries; use recipes_getRecipe for a recipe's full detail.

Save a recipe the user provides (dictated or pasted). For fetching from the web, prefer recipes_generateRecipe.

{
  "recipe": {
    "title": "Weeknight dal",
    "servings": 4,
    "prepMinutes": 10,
    "cookMinutes": 30,
    "cuisine": "Indian",
    "courses": [
      "dinner"
    ],
    "ingredients": [
      {
        "name": "red lentils",
        "quantity": "1",
        "unit": "cup"
      },
      {
        "name": "onion",
        "quantity": "1",
        "note": "diced"
      }
    ],
    "steps": [
      {
        "text": "Rinse the lentils."
      },
      {
        "text": "Simmer with onion and spices for 25 minutes."
      }
    ]
  }
}

Push a recipe's ingredients into a grocery list. Creates a new list when no listId is given. Scale amounts with servingsMultiplier.

Note: Adds a recipe's ingredients to a grocery list; creates the list when no listId is given.

Update fields on an existing recipe.

Set or clear a recipe's star rating.

Delete a saved recipe. Only for explicit removals.

List meal plan entries in a date range, ordered by date and slot.

Schedule a recipe (or an ad-hoc meal) onto a date and meal slot. Provide recipeId for a saved recipe, or recipeTitle for an ad-hoc meal.

{
  "entry": {
    "date": "2026-09-29",
    "mealSlot": "dinner",
    "recipeId": "recipe_dal",
    "servings": 4
  }
}

Update a meal plan entry (move date/slot, change servings or notes).

Mark a planned meal as cooked, skipped, or back to planned.

Remove a meal plan entry. Only for explicit removals.