Search recipes
search_recipesSearch recipes by food, keyword, or book names in one request, then filter by rating, cook history, on-hand ingredients, exclusions, and pagination.
Instructions
High-level recipe search. Accepts food/keyword/book names (not IDs) and resolves them internally, typically collapsing 3-4 round-trips into 1. Example: {foods: ["chicken", "broccoli"], exclude_foods: ["peanuts"], keywords: ["weeknight"]}. For complex ID-based filtering, fall back to list_recipes.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_recipes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting at 1. | |
| books | No | Recipe book names; recipe must be in ANY of these | |
| foods | No | Food names the recipe must contain ALL of | |
| query | No | Fuzzy match against recipe names | |
| format | No | Response detail level. Default "slim". | |
| random | No | Return results in random order. | |
| makenow | No | Only recipes makeable with currently on-hand foods | |
| keywords | No | Keyword names; recipe must have ANY of these | |
| page_size | No | Results per page. Default 25, max 100. | |
| rating_gte | No | Minimum rating. | |
| rating_lte | No | Maximum rating. | |
| sort_order | No | score | -score | name | -name | lastcooked | -lastcooked | rating | -rating | times_cooked | -times_cooked | |
| exclude_foods | No | Food names the recipe must NOT contain any of | |
| timescooked_gte | No | Minimum number of times cooked. | |
| timescooked_lte | No | Maximum number of times cooked. | |
| exclude_keywords | No | Keyword names to exclude |