Homebox MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LAN_LINKS | No | Use LAN for display links (default: false) | false |
| USE_LAN_API | No | Use LAN for API calls (default: true) | true |
| HOMEBOX_API_KEY | No | Persistent API key from Homebox | |
| HOMEBOX_WAN_URL | No | WAN/public URL for external access | |
| HOMEBOX_PASSWORD | No | Your Homebox password | |
| HOMEBOX_USERNAME | No | Your Homebox username (email) | |
| HOMEBOX_LOCAL_URL | Yes | LAN URL for your Homebox instance |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_itemsC | List inventory items from Homebox. Supports filtering by page number and location. |
| get_itemA | Get detailed information about a specific inventory item by ID |
| create_itemB | Create a new inventory item in Homebox |
| update_itemB | Update an existing inventory item |
| delete_itemB | Delete an inventory item by ID |
| list_locationsA | List all storage locations in Homebox |
| create_locationC | Create a new storage location |
| list_labelsA | List all labels/tags in Homebox |
| create_labelC | Create a new label/tag |
| search_itemsC | Search for items using a query string. Searches across item names, descriptions, and other fields. |
| get_item_linkA | Get the direct link to an item by searching for it using asset ID, name, or description. This is the preferred tool when users ask for links to specific items. Returns the direct clickable URL. |
| set_item_parentA | Set or change the parent item for an item. This creates a parent-child relationship where the item becomes a child of another item (e.g., putting an item inside a box). |
| remove_item_parentA | Remove the parent relationship from an item. This makes the item no longer a child of another item. |
| add_item_fieldA | Add or update a custom field on an item. Custom fields can store additional metadata like ISBN, serial numbers, or any other custom data. Supports text, number, boolean, and time field types. |
| remove_item_fieldB | Remove a custom field from an item by field name. |
| get_locations_treeA | Get the hierarchical tree structure of all locations in Homebox. Shows parent-child relationships between locations. |
| get_locationA | Get detailed information about a specific location by ID, including its children and parent. |
| update_locationB | Update an existing location's name, description, or parent. |
| update_labelB | Update an existing label's name, description, or color. |
| search_barcodeA | Search for product information using a barcode (EAN/UPC). Returns product details from barcode lookup services. |
| add_item_attachmentA | Add an attachment (image, document, etc.) to an inventory item. The file_location can be either a URL (http:// or https://) to fetch the file from, or an absolute file path on the local filesystem (e.g., '/mnt/images/photo.png'). The filename is automatically extracted from the URL or path. Supported file types include images (jpg, png, gif, webp), documents (pdf, doc, docx), and other common formats. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 21 tools
Each tool targets a distinct operation or resource. There is no overlap between item, label, location, or barcode operations. Even similar tools like get_item and search_items serve different lookups (exact ID vs query).
Most tools follow verb_noun pattern (list_items, create_item, update_item). Exceptions include add_item_field (add vs create) and remove_item_parent (remove vs delete). 'get_locations_tree' uses plural 'locations', and 'search_barcode' differs from 'search_items'. Overall consistent but with minor deviations.
21 tools is well-scoped for a home inventory management server. Each tool serves a clear purpose without excess, covering items, locations, labels, attachments, fields, and barcode search.
The tool set provides full CRUD for items, locations, and labels, plus attachments, custom fields, parent relationships, tree hierarchy, item links, and barcode search. No obvious missing functionality for typical home inventory tasks.