# Dgahagan Homebox MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.dgahagan%2Fhomebox-mcp
Registry id: `mcp-registry/io.github.dgahagan/homebox-mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "dgahagan-homebox-mcp-server": {
      "command": "uvx",
      "args": [
        "homebox-mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add dgahagan-homebox-mcp-server -- uvx homebox-mcp
```

## Tools (11)

- `barcode_lookup`: UPC/EAN → name/manufacturer/model (optional, for boxed goods).
- `create_item`: Create and enrich an item in one call. fields is a dict typed by JSON value (string→text, number→number [integer-coerced], bool→boolean); tags must already exis
- `create_location`: Create a location (tote/bin/shelf) to bootstrap a new storage spot; description doubles as a contents manifest.
- `duplicate_item`: Duplicate an item ("I bought a second one"). Copied custom fields include the alias.
- `get_item`: Full detail for one item: location path, identity, purchase, warranty, custom fields, tags, attachments.
- `import_csv`: Bulk-create items and locations from a Homebox CSV in one multipart request. HB.location auto-creates the path hierarchy; recognizes HB.name, HB.tags, HB.quanti
- `list_locations`: The full location tree as an indented outline.
- `list_tags`: All tag (label) names; detail=True returns full objects (description, color, icon, parent tag).
- `location_contents`: Items directly in a location plus its sub-location names; recursive=True walks the whole subtree and returns every nested item with its full location path.
- `search_items`: Search items by keyword and/or tag names (AND of both); returns each with assetId, location, and the alias field.
- `warranties_expiring`: Items whose warranty expires in after…before (after defaults to today, excluding already-expired); lifetime=True lists lifetime-warranty items.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.