com.pantryaide/pantry-aide

Official

by hsearcy

AI meal plans that fill your Kroger/Instacart cart - pantry-aware lists, all from chat.

Generate meal plans that automatically populate shopping carts at Kroger or Instacart.

README.md5 KBView on GitHub

Pantry Aide — MCP Server 🐴

Plan your week's meals and fill your grocery cart — without leaving your AI assistant.

Pantry Aide is a hosted (remote) Model Context Protocol server that runs the entire meal‑plan‑to‑checkout journey on behalf of a signed‑in user.

Most meal‑planning tools stop at "here's a plan." Pantry Aide closes the loop to actual groceries:

Plan — generate a weekly meal plan (mains + sides) from your own recipes, honoring a free‑text request like "mostly chicken, nothing too hard."
Shop list — build a pantry‑aware shopping list that automatically skips staples you likely already have, then refine it.
Checkout — push the list to your live Kroger cart, or generate an Instacart deep link.

All from chat: "Plan 5 easy dinners this week, swap Tuesday for something lighter, then send the cart to Kroger."

Connecting

The server speaks Streamable HTTP at:

code

https://pantryaide.com/mcp

You need a free Pantry Aide account. Kroger checkout requires connecting a Kroger account once in the web app; Instacart works without extra setup.

Option A — OAuth one‑click (Claude.ai, Claude Desktop, Claude for Work)

Add a custom connector / integration pointing at https://pantryaide.com/mcp. The server advertises OAuth 2.1 discovery and Dynamic Client Registration, so the client walks you through sign‑in automatically — no manual token needed.

Option B — Bearer API key (Cursor, Windsurf, custom clients)

Sign in at pantryaide.com and generate an API key (looks like pa_live_…).
Add the server to your client config:

Native remote transport (header auth):

json

{
  "mcpServers": {
    "pantry-aide": {
      "url": "https://pantryaide.com/mcp",
      "headers": { "Authorization": "Bearer pa_live_YOUR_KEY" }
    }
  }
}

Via mcp-remote (for stdio‑only clients):

json

{
  "mcpServers": {
    "pantry-aide": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://pantryaide.com/mcp",
        "--header", "Authorization: Bearer pa_live_YOUR_KEY"
      ]
    }
  }
}

Tools (22)

Recipes

Tool	What it does
`list_recipes`	List your recipes (owned + saved), cursor‑paginated
`get_recipe`	Full details (ingredients, instructions, timing) for one recipe
`discover_recipes`	Browse public recipes; filter by query/tag/difficulty/meal type
`save_recipe`	Save a public recipe to your collection (idempotent)
`create_recipe`	Author a new recipe
`update_recipe`	Edit fields on a recipe you own
`delete_recipe`	Delete a recipe you own (destructive)

Meal plans

Tool	What it does
`generate_meal_plan`	AI‑generate a weekly plan (mains + sides) from your recipes
`list_meal_plans`	List your meal plans
`get_meal_plan`	Full plan details (planned meals + recipes + ingredients)
`suggest_recipe_replacements`	Propose alternatives for a planned slot
`replace_planned_meal`	Swap one slot to a different recipe
`add_planned_meal`	Add a meal/side to a date
`remove_planned_meal`	Remove a meal from a plan

Shopping list

Tool	What it does
`create_shopping_list_from_plan`	Build a pantry‑aware list (to_buy vs. excluded)
`update_shopping_list_items`	Toggle selected / edit quantity, unit, notes
`add_custom_item`	Add a manual item (paper towels, snacks, …)

Kroger checkout

Tool	What it does
`prepare_kroger_cart`	Match items to Kroger products (auto / needs‑review / unmatched)
`search_kroger_alternatives`	Refresh candidates for one item
`select_kroger_products`	Persist UPC choices
`submit_kroger_cart`	Push items to your live Kroger cart (destructive)

Instacart

Tool	What it does
`create_instacart_link`	Generate an Instacart deep link for the selected items

Example prompts

"Plan 5 easy dinners for this week — mostly chicken, nothing too hard."
"Build my shopping list and skip anything I probably already have."
"Swap Tuesday's dinner for something lighter, then re‑do the list."
"Add a vegetable side to Thursday."
"Send the cart to Kroger when it looks good." → review → "yep, submit it."
"Just make me an Instacart link for this week's groceries."

Install

claude_desktop_config.json

{
  "mcpServers": {
    "pantry-aide": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pantryaide.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.