OpenParable
Skip to content
← Back to skills

Grocery List

Productivity
grocery-list

Grocery List is an Agent Skill for productivity published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Standalone grocery lists, recipes, and meal planning with local storage. No external service required.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/grocery-list/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/grocery-list, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Grocery List & Meal Planner

Self-contained grocery lists, recipes, and meal planning with local JSON storage. No subscriptions or external services required.

Features

  • Multiple lists — Grocery, Costco, Target, etc.
  • Smart categories — produce, dairy, meat, bakery, frozen, pantry, household
  • Quantity parsing — "2 gallons milk" → quantity: 2, unit: "gallon"
  • Recipe storage — Save recipes with ingredients
  • Meal planning — Plan meals by date and type (breakfast/lunch/dinner)
  • Recipe-to-list — Add recipe ingredients to any list with one command
  • Family assignment — Assign items to household members
  • Notifications — notify command for heartbeat/cron integration

Commands

Lists

uv run {baseDir}/scripts/grocery.py lists                    # Show all lists
uv run {baseDir}/scripts/grocery.py list "Grocery"           # Show items in a list
uv run {baseDir}/scripts/grocery.py list "Grocery" --unchecked
uv run {baseDir}/scripts/grocery.py list create "Costco"     # Create new list
uv run {baseDir}/scripts/grocery.py list delete "Costco"     # Delete a list

Items

uv run {baseDir}/scripts/grocery.py add "Grocery" "Milk"
uv run {baseDir}/scripts/grocery.py add "Grocery" "Milk" --category dairy --qty "2 gallons"
uv run {baseDir}/scripts/grocery.py add "Grocery" "Chicken" --assignee "Erin"
uv run {baseDir}/scripts/grocery.py check "Grocery" "Milk"
uv run {baseDir}/scripts/grocery.py uncheck "Grocery" "Milk"
uv run {baseDir}/scripts/grocery.py remove "Grocery" "Milk"
uv run {baseDir}/scripts/grocery.py clear "Grocery"          # Clear checked items

Recipes

uv run {baseDir}/scripts/grocery.py recipes                  # List all recipes
uv run {baseDir}/scripts/grocery.py recipe "Tacos"           # View a recipe
uv run {baseDir}/scripts/grocery.py recipe add "Tacos" --ingredients "ground beef,tortillas,cheese,lettuce,tomatoes"
uv run {baseDir}/scripts/grocery.py recipe add "Tacos" --category "Mexican" --servings 4
uv run {baseDir}/scripts/grocery.py recipe delete "Tacos"
uv run {baseDir}/scripts/grocery.py recipe search "chicken"

Meal Planning

uv run {baseDir}/scripts/grocery.py meals                    # Show this week's meals
uv run {baseDir}/scripts/grocery.py meals --date 2026-01-15
uv run {baseDir}/scripts/grocery.py meal add --date 2026-01-15 --type dinner --recipe "Tacos"
uv run {baseDir}/scripts/grocery.py meal add-to-list --date 2026-01-15 --list "Grocery"
uv run {baseDir}/scripts/grocery.py meal remove --date 2026-01-15 --type dinner

Notifications

uv run {baseDir}/scripts/grocery.py notify                   # Pending alerts for heartbeat
uv run {baseDir}/scripts/grocery.py stats                    # Quick summary

Categories

Built-in categories with automatic detection:

  • produce — fruits, vegetables
  • dairy — milk, cheese, eggs, yogurt
  • meat — chicken, beef, pork, fish
  • bakery — bread, rolls, bagels
  • frozen — ice cream, frozen meals
  • pantry — canned goods, pasta, rice
  • beverages — drinks, soda, juice
  • snacks — chips, crackers
  • household — cleaning, paper goods
  • personal — toiletries, medicine
  • other — uncategorized

JSON Output

All commands support --json for programmatic access:

uv run {baseDir}/scripts/grocery.py list "Grocery" --json
uv run {baseDir}/scripts/grocery.py recipes --json
uv run {baseDir}/scripts/grocery.py meals --json

Data Storage

Data is stored locally at ~/.clawdbot/grocery-list/data.json. No cloud account required.

Usage Examples

"Add milk and eggs to the grocery list"

uv run {baseDir}/scripts/grocery.py add "Grocery" "Milk" --category dairy
uv run {baseDir}/scripts/grocery.py add "Grocery" "Eggs" --category dairy

"What's on the grocery list?"

uv run {baseDir}/scripts/grocery.py list "Grocery" --unchecked

"Plan tacos for dinner on Saturday"

uv run {baseDir}/scripts/grocery.py meal add --date 2026-01-18 --type dinner --recipe "Tacos"

"Add the taco ingredients to the grocery list"

uv run {baseDir}/scripts/grocery.py meal add-to-list --date 2026-01-18 --list "Grocery"

"Check off the milk"

uv run {baseDir}/scripts/grocery.py check "Grocery" "Milk"