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 |
Capabilities
Features and capabilities supported by this server
| 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 | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Supermaxman/Homebox-MCP-Server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server