Allourthings MCP server

AllOurThings

Your things, understood by AI.

AllOurThings is an inventory system that works the way you do. Catalog anything you like from your home appliances to your Pokémon cards — then ask plain-English questions and get instant answers.

Website: allourthings.io

Packages

Quick start

Desktop only. Requires macOS, Windows, or Linux with Claude Desktop or another MCP-compatible client.

1. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):

{
  "mcpServers": {
    "allourthings": {
      "command": "npx",
      "args": ["-y", "@allourthings/mcp-server", "--data-dir", "~/Documents/AllOurThings"]
    }
  }
}

Restart Claude Desktop. Your inventory vault will be created automatically on first use.

2. Start asking questions

• "Add my Bosch washing machine, bought from John Lewis for £649 in January 2024 with a 2-year warranty"
• "What appliances do I own?"
• "What's in the kitchen?"
• "When does my TV warranty expire?"
• "Search for anything Samsung"
• "How much have I spent on electronics?"

How it works

The MCP server exposes your inventory to any MCP-compatible AI client via 10 tools:

Data

Vault structure

Your inventory lives in a vault — a plain directory on your filesystem. Each item gets its own folder:

~/Documents/AllOurThings/
  items/
    dyson-v15-detect-a1b2c3d4/
      item.json
      manual.pdf
      receipt.jpg
    samsung-65-qled-tv-b5c6d7e8/
      item.json
      warranty.pdf

Attachments (manuals, receipts, photos) sit alongside the item JSON. You can browse and edit the vault directly in Finder or File Explorer.

Item schema

Every item has required fields (id, name, createdat, updatedat) and well-known optional fields:

category brand model purchasedate purchaseprice currency warranty_expires retailer location features notes tags attachments

The attachments field links PDFs and images stored in the item's folder:

{
  "attachments": [
    { "filename": "manual.pdf",  "type": "manual"   },
    { "filename": "receipt.jpg", "type": "receipt"  },
    { "filename": "photo.jpg",   "type": "photo"    }
  ]
}

You can also add any custom fields you like — they are preserved as-is.

CLI

A standalone terminal tool for power users and scripting. Works on macOS, Windows, and Linux. No AI client required.

# Run without installing
npx @allourthings/cli list

# Or install globally
npm install -g @allourthings/cli

Commands

Shortened. The full README is on GitHub.