import_csv
Import a Homebox CSV to bulk-create items and locations, automatically creating location hierarchies and handling custom fields and warranty info. One request replaces many API calls.
Instructions
Bulk-create items and locations from a Homebox CSV (multipart import).
This is the bulk creator for the photo-intake pipeline — one request imports everything, avoiding ~4 API calls per item. Recognized columns: HB.name, HB.location (path e.g. "Garage/Loft" — AUTO-CREATES the hierarchy), HB.tags (must already exist; see list_tags), HB.quantity, HB.serial_number, HB.model_number, HB.manufacturer, HB.notes, HB.purchase_price, HB.purchase_from, HB.purchase_time, HB.warranty_expires, HB.field. (custom fields). A location-only row (HB.location set, contents described elsewhere) creates just the location. After import, call finalize_photos if you attached photos. Returns the count of data rows submitted.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"csv_text": "<csv_text>"
},
"name": "import_csv"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| csv_text | Yes |