warehouse-mcp

MCP server for the warehouse home inventory system.

Tools

Tool	Description
list_boxes	List boxes (all, root only, or children of a box)
get_box	Get a box by ID with its items
create_box	Create a new box
update_box	Update a box label or description
delete_box	Delete an empty box
list_items	List or full-text search items
get_item	Get an item by ID with active checkouts
create_item	Create a new item
update_item	Update item fields
delete_item	Delete an item
list_checkouts	List active (not returned) checkouts
checkout_item	Check out an item
return_checkout	Return a checkout

Usage

Environment variables

Variable	Description
WAREHOUSE_API_URL	Base URL of the warehouse API (e.g. https://api.warehouse.kwasek.org)
WAREHOUSE_API_TOKEN	Bearer token for API authentication

Docker

docker run --rm -i \
  -e WAREHOUSE_API_URL=https://api.warehouse.kwasek.org \
  -e WAREHOUSE_API_TOKEN=your_token \
  ghcr.io/kwasek404/warehouse-mcp

Claude Desktop / claude.json

{
  "mcpServers": {
    "warehouse": {
      "command": "docker",
      "args": ["run", "--rm", "-i",
        "-e", "WAREHOUSE_API_URL=https://api.warehouse.kwasek.org",
        "-e", "WAREHOUSE_API_TOKEN=your_token",
        "ghcr.io/kwasek404/warehouse-mcp"
      ]
    }
  }
}