AllOurThings

Household and personal inventory management, backed by a local or cloud-synced

vault (iCloud Drive, Dropbox, OneDrive, or any folder).

When to Use

✅ USE this skill when the user asks about:

• Their belongings, possessions, or household items
• Appliances, electronics, tools, furniture, vehicles, collectibles
• Warranties — "is my TV still under warranty?", "what warranties are expiring?"
• Purchase history — "when did I buy my washing machine?", "how much did I pay?"
• Finding something — "where did I put my drill?", "do I own a label maker?"
• Adding or cataloguing a new item
• Searching across their inventory — "list all Bosch appliances"
• Attaching or retrieving photos, receipts, manuals, or warranty documents

When NOT to Use

❌ DON'T use this skill when:

• The user is asking about general product information or reviews (no inventory context)
• The question is about shopping or buying something new (unless checking existing inventory first)
• The vault is not configured — prompt the user to set ALLOURTHINGS_DATA_DIR

Setup

The user must set ALLOURTHINGS_DATA_DIR to the path of their AllOurThings

vault folder.

# Example — iCloud Drive vault
export ALLOURTHINGS_DATA_DIR="$HOME/Library/Mobile Documents/com~apple~CloudDocs/Documents/allourthings-vault"

# Example — Dropbox
export ALLOURTHINGS_DATA_DIR="$HOME/Dropbox/AllOurThings"

# Example — local folder
export ALLOURTHINGS_DATA_DIR="$HOME/Documents/AllOurThings"

Add this to your shell profile (~/.zshrc, ~/.bashrc) to make it permanent.

The vault is a plain folder of JSON files — create it anywhere you like, or

point it at an existing folder to start cataloguing immediately.

Available Tools

Example Interactions

"What electronics do I own?"

→ list_items with category: "Electronics"

"Is my dishwasher still under warranty?"

→ search_items for "dishwasher", check warranty_expires

"I just bought a Dyson V15 vacuum for £499"

→ add_item with name, brand, purchase price, and date

"Show me everything I bought from Amazon last year"

→ search_items for "Amazon" or list_items filtered by retailer

"Attach the receipt for my MacBook"

→ add_attachment with kind receipt

CLI

AllOurThings also ships a standalone CLI (@allourthings/cli) for scripting

and automation outside of an AI session:

npx @allourthings/cli list
npx @allourthings/cli search "bosch"
npx @allourthings/cli add --name "Dyson V15" --category "Appliances"

Set ALLOURTHINGS_DATA_DIR or pass --data-dir to point at your vault.

Notes

• Data is stored as plain JSON files — fully portable, no lock-in
• Works with any sync provider that exposes a local folder path (iCloud Drive, Dropbox, OneDrive, etc.)
• The MCP server and CLI share the same vault format — interchangeable