Scraps Kitchen

scraps-mcp MCP server

Your AI assistant's cooking brain. Scraps Kitchen gives any AI agent persistent, household-aware kitchen intelligence — pantry tracking, dietary safety, recipe management, shopping lists, and more.

Unlike generic chatbot memory, Scraps maintains structured cooking data: what's in your fridge, who you cook for, their allergies and preferences, your recipe history with cook notes, and your kitchen equipment. Any MCP-compatible agent can tap into this to have genuinely personalized cooking conversations.

Live server: https://api.scraps.kitchen/mcp (Streamable HTTP) Web app: scraps.kitchen

---

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "scraps-kitchen": {
      "type": "streamable-http",
      "url": "https://api.scraps.kitchen/mcp"
    }
  }
}

VS Code / Cursor

Add to your MCP settings:

{
  "servers": {
    "scraps-kitchen": {
      "type": "streamable-http",
      "url": "https://api.scraps.kitchen/mcp"
    }
  }
}

On first use, you'll be prompted to authenticate via OAuth. You can create an account directly in the OAuth flow — a one-time code is sent to your email for verification. No need to visit scraps.kitchen separately.

---

Tools (27)

Meal Suggestions

Tool	Description
suggest_quick_meal	Generate a recipe from ingredients. 1 free call per user per 24 hours.

Pantry (6 tools)

Tool	Description
get_pantry	List pantry items with category, quantity, stock status, perishability, and storage hints. Filter by in-stock or stale items.
add_pantry_items	Add up to 50 items at once. Auto-enriched with food intelligence.
update_pantry_item	Update name, quantity, unit, category, or stock status.
remove_pantry_item	Permanently delete a pantry item.
mark_ingredients_used	Mark ingredients as consumed after cooking. Fuzzy name matching. Staples auto-skipped.
confirm_pantry_fresh	Reset staleness clock on items the user confirms are still good.

Shopping List (5 tools)

Tool	Description
get_shopping_list	List shopping items with checked status. Filter by bought/remaining.
add_shopping_list_item	Add a single item to the list.
add_recipe_to_shopping_list	Add all ingredients from a saved recipe at once.
check_off_shopping_item	Mark items as bought or still needed.
remove_shopping_list_item	Remove a single item.
clear_checked_shopping_items	Remove all checked-off items at once (post-shopping cleanup).

Household (4 tools)

Tool	Description
get_household	List household members with allergens, restrictions, preferences, dislikes, goals, and life stages.
add_diner	Add a household member with dietary profile.
update_diner	Update dietary details. Array fields replace entirely — send the full list.
remove_diner	Remove a member and their recipe ratings.

Equipment (4 tools)

Tool	Description
get_equipment	List kitchen equipment (tools, appliances).
add_equipment	Add a piece of equipment with optional notes.
update_equipment	Update equipment name or notes.
remove_equipment	Remove equipment from inventory.

Recipes (6 tools)

Tool	Description
get_recipes	List saved recipes. Search by keyword, filter by status or favorites.
get_recipe	Full recipe detail: ingredients, steps, cook notes, diner ratings.
update_recipe	Update title, status, rating, favorite, or sharing status.
delete_recipe	Permanently delete a recipe and all associated data.
add_recipe_note	Record cook notes — observations, modifications, per-cook ratings.
rate_recipe_for_diner	Track which household members loved which recipes.

---

Authentication

All tools require authentication. Scraps uses OAuth 2.1 with PKCE — most MCP clients handle this automatically. You'll see a login prompt on first connection, where you can sign in or create a new account with email OTP verification.

Scopes:

Scope	Access
read:pantry	View pantry inventory
read:household	View household dietary info
read:recipes	View saved recipes
write:pantry	Update pantry
write:recipes	Save recipes and cooking notes
write:shopping	Manage shopping list
write:household	Manage household members
write:equipment	Manage kitchen equipment

Discovery: https://api.scraps.kitchen/.well-known/mcp.json

---

How Agents Use Scraps

Scraps is a data layer, not a reasoning engine. It stores structured kitchen intelligence that makes any AI assistant better at cooking conversations:

1. Read the kitchen context — get_pantry, get_household, get_equipment, get_recipes
2. Use your own LLM to reason about what to cook, considering allergies, preferences, and available ingredients
3. Write back results — mark_ingredients_used, add_recipe_note, rate_recipe_for_diner

Every interaction makes the data richer. More cook history, more diner feedback, more pantry accuracy — which makes the next conversation better.

---

Example Workflows

"What should I cook tonight?"

1. get_pantry → see available ingredients
2. get_household → check dietary constraints and allergens
3. get_equipment → know what tools are available
4. get_recipes(status: "cooked") → see what's worked before
5. Agent reasons about a meal suggestion using all this context

After cooking:

1. mark_ingredients_used(["chicken thighs", "ginger", "soy sauce"]) → update pantry
2. add_recipe_note(recipe_id, "Added extra garlic, seared 2 min longer") → build cook history
3. rate_recipe_for_diner(recipe_id, diner_id, { loved_it: true }) → track preferences

Grocery planning:

1. get_pantry(stale_only: true) → items past freshness window
2. get_shopping_list → existing list
3. add_shopping_list_item("eggs") → add what's needed
4. After shopping: add_pantry_items([...]) → restock, clear_checked_shopping_items → clean up list

---

Links

• Web app: scraps.kitchen
• MCP endpoint: https://api.scraps.kitchen/mcp
• Discovery: https://api.scraps.kitchen/.well-known/mcp.json
• Official MCP Registry: registry.modelcontextprotocol.io

---

License

MIT