🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί OurGroceries Integration
πŸ¦€ ClawHub

OurGroceries Integration

by @poedenon

Skill for interacting with OurGroceries.com to manage shopping lists. Use when you need to add items to grocery lists, check existing lists, or synchronize w...

Versionv1.0.2
Downloads327
#requires-sensitive-credentials#clawhub
TERMINAL
clawhub install ourgroceries

πŸ“– About This Skill

name: ourgroceries description: Skill for interacting with OurGroceries.com to manage shopping lists. Use when you need to add items to grocery lists, check existing lists, or synchronize with OurGroceries.com account. Enables programmatic grocery list management through voice or text commands using the unofficial Python wrapper.

OurGroceries Integration

Overview

This skill provides integration with OurGroceries.com using an unofficial Python wrapper, allowing you to manage your grocery lists through natural language commands. You can add items to lists, check what's on your lists, and synchronize with your OurGroceries.com account.

Setup Required

To use this skill, you need to: 1. Have an OurGroceries.com account (email and password) 2. Install aiohttp (see requirements.txt). Scripts load a vendored client from lib/ourgroceries/ (patched for current OurGroceries APIs, including getItemCategory + getLists / auto-categorize parity with the web app). 3. Configure your credentials securely

Quick Start

Adding Items

To add an item to your grocery list, simply say or type:
  • "Add milk to my grocery list"
  • "I need eggs and bread for shopping"
  • "Put apples on OurGroceries"

    • Checking Lists

    To see what's on your list:
  • "What's on my grocery list?"
  • "Show me OurGroceries"
  • "List items for shopping"

    • Available Operations

    Once configured with your OurGroceries.com credentials, this skill supports:

  • Adding items to specific lists or default list
  • Retrieving items from lists
  • Removing items from lists
  • Marking items as purchased
  • Creating new lists
  • Deleting lists
  • Synchronizing with OurGroceries.com

    • Resources

    scripts/

    Contains executable scripts for interacting with OurGroceries.com via the unofficial Python wrapper:
  • add_item.py - Add items to grocery lists
  • get_list.py - Retrieve current list items
  • remove_item.py - Remove items from lists
  • devtools_network_monitor.js - Paste in browser DevTools to log POST JSON (see file header)

    • references/

    Documentation and usage guides:
  • api_reference.md - OurGroceries.com API endpoints and authentication (based on unofficial wrapper)
  • authentication.md - How to obtain and use API credentials (email/password)
  • examples.md - Common usage patterns and examples

    • Configuration

    Before using this skill, you'll need to: 1. Visit https://www.ourgroceries.com and note your login email and password 2. Store these credentials securely (we recommend using environment variables or a secure vault) 3. The scripts will look for credentials in environment variables: - OURGROCERIES_EMAIL: Your OurGroceries.com login email - OURGROCERIES_PASSWORD: Your OurGroceries.com login password

    Credits

  • Based on py-our-groceries by ljmerza.

    • If you encounter issues, check the references/ directory for troubleshooting tips and current status.

    Example Usage

    After setting environment variables: 

    OURGROCERIES_EMAIL="your@email.com" OURGROCERIES_PASSWORD="yourpassword" \
  python3 /path/to/skill/scripts/add_item.py "milk" -l "My Grocery List"
    (add_item.py uses auto-categorize via getItemCategory + insertItem; see AGENTS.md in this skill folder.)

    πŸ’‘ Examples

    Adding Items

    To add an item to your grocery list, simply say or type:
  • "Add milk to my grocery list"
  • "I need eggs and bread for shopping"
  • "Put apples on OurGroceries"

    • Checking Lists

    To see what's on your list:
  • "What's on my grocery list?"
  • "Show me OurGroceries"
  • "List items for shopping"

    • βš™οΈ Configuration

    Before using this skill, you'll need to: 1. Visit https://www.ourgroceries.com and note your login email and password 2. Store these credentials securely (we recommend using environment variables or a secure vault) 3. The scripts will look for credentials in environment variables: - OURGROCERIES_EMAIL: Your OurGroceries.com login email - OURGROCERIES_PASSWORD: Your OurGroceries.com login password