Skip to main content
Glama
luisriverag

homebox-mcp

by luisriverag

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
READONLYYesY for read-only mode, N for full read & write access.
HOMEBOX_URLYesBase URL of your Homebox instance, e.g. http://homebox:7745
HOMEBOX_PASSWORDYesPassword for the Homebox account.
HOMEBOX_USERNAMEYesLogin for a Homebox account the agent uses.

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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
items_listC

List/search items in the Homebox inventory. Supports free-text search and filtering by label, location, or parent item.

items_getA

Get full details of a single item by ID.

items_pathA

Get the breadcrumb path (ancestor locations) of an item.

items_fieldsA

List the distinct custom field names used across all items.

items_field_valuesB

List the distinct values used for a given custom field name.

items_exportA

Export the full inventory as a CSV string.

items_attachment_getB

Get metadata for a single item attachment.

items_maintenance_listA

List maintenance log entries for an item.

locations_listB

List all storage locations.

locations_treeA

Get the full nested tree of locations (and optionally items within them).

locations_getB

Get details of a single location, including items stored in it.

labels_listA

List all labels/tags.

labels_getA

Get details of a single label, including items tagged with it.

notifiers_listA

List configured notifiers (e.g. Shoutrrr/Apprise notification URLs for maintenance reminders).

users_self_getA

Get the profile of the currently authenticated Homebox user.

group_getA

Get the current Homebox group's settings (name, currency, etc).

group_statisticsA

Get high-level inventory statistics for the group (total items, total value, etc).

group_statistics_labelsA

Get item-count statistics broken down by label.

group_statistics_locationsA

Get item-count statistics broken down by location.

group_statistics_purchase_priceC

Get total purchase price statistics over time.

status_getA

Get the Homebox server status/version/health info.

currency_listA

List the currencies Homebox supports.

assets_get_by_idB

Look up an item by its short numeric asset ID (as printed on asset labels/QR codes).

qrcode_generateA

Generate a QR code image encoding the given data. Returns base64-encoded JPEG bytes.

reporting_bill_of_materialsA

Export a full bill-of-materials report of the inventory as a CSV string.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

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/luisriverag/homebox_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server