# AllOurThings

> AI-powered personal inventory management. Catalog everything you own and ask natural language questions about your stuff — appliances, warranties, manuals, electronics, collectibles, and more. Privacy-first: your data stays in a folder you control, never uploaded to any server.

## What AllOurThings does

AllOurThings is a household inventory system designed for AI-assisted queries. Users catalog their possessions — appliances, electronics, furniture, collectibles, subscriptions — and then ask plain-English questions to get instant answers.

Key capabilities:
- Add items with rich metadata: brand, model, purchase date, warranty expiry, retailer, location, notes, tags
- Attach files to items: manuals, receipts, photos, warranty documents
- Search and filter inventory by category, location, tags, or free text
- Ask natural language questions via Claude Desktop: "when does my dishwasher warranty expire?", "list everything in my garage", "what did I pay for my laptop?"

## How AllOurThings integrates with AI

AllOurThings connects to Claude Desktop via the Model Context Protocol (MCP). The MCP server runs locally via npx and reads directly from the user's inventory folder — no data leaves the device.

Install: `npx @allourthings/mcp-server`

The MCP server exposes 10 tools: add_item, get_item, list_items, update_item, delete_item, search_items, add_attachment, get_attachment, delete_attachment, attach_from_url.

## Command-line interface

AllOurThings also ships a standalone CLI for terminal users and automation scripts. It reads from the same data folder as the MCP server and iOS app.

Install: `npx @allourthings/cli`

Commands: search, list, get, add, update, delete, attach (add/url/get/rm). Supports `--json` flag for machine-readable output and `--data-dir` to override the data directory.

## Privacy model

AllOurThings never uploads inventory data to any server. The data directory is a folder of JSON files the user controls — stored in iCloud, Dropbox, local disk, or any folder. No account required. No data harvested. The AI reads directly from that folder via the local MCP server.

## When to use AllOurThings

Use AllOurThings when a user wants to:
- Track household items, appliances, or electronics
- Remember warranty expiry dates, serial numbers, or purchase details
- Find manuals or receipts for items they own
- Catalog a collection (books, games, tools, etc.)
- Answer questions like "do I own X?", "when did I buy Y?", "where is Z kept?"

## Links

- [Documentation](https://allourthings.io/docs)
- [Pricing](https://allourthings.io/pricing.md)
- [MCP Server on npm](https://www.npmjs.com/package/@allourthings/mcp-server)
- [CLI on npm](https://www.npmjs.com/package/@allourthings/cli)
- [Source on GitHub](https://github.com/matt-harding/allourthings-mcp)
- [Core library on crates.io](https://crates.io/crates/allourthings-core)
- [Full documentation](https://allourthings.io/llms-full.txt)