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.

bash

# 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#

ToolDescriptionlist_itemsList all items, optionally filtered by category, subcategory, or tagssearch_itemsFull-text search across all item fieldsget_itemRetrieve a single item by ID or nameadd_itemAdd a new item to the vaultupdate_itemUpdate fields on an existing itemdelete_itemDelete an item and all its attachmentsget_item_fieldsList all field names in use across the vaultadd_attachmentAttach a photo, receipt, manual, or warranty documentget_attachmentRetrieve an attachment's raw bytesattach_from_urlDownload a file from a URL and attach it to an itemdelete_attachmentRemove an attachment from an item

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:

bash

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