Homebox MCP Server

Homebox home inventory: search, intake, warranties, attachments, locations, tags, QR labels

Local serverstdioPython

What is the Homebox MCP Server?

Homebox home inventory: search, intake, warranties, attachments, locations, tags, QR labels

What the server does

You need a running Homebox instance (0.26+, see Requirements) and an API key from Profile → API Keys in the Homebox web UI.

Credentials and setup notes

  • Homebox 0.26 or newer — the actively maintained sysadminsmedia fork at homebox.software. This server speaks the unified entities API introduced in 0.26. Older instances use a different API (/items, /locations, /labels) and are rejected on the first tool call with a clear error rather than failing cryptically.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Homebox MCP Server

{
  "mcpServers": {
    "homebox": {
      "command": "uvx",
      "args": ["homebox-mcp"],
      "env": {
        "HOMEBOX_URL": "your-value",
        "HOMEBOX_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Homebox 0.26 or newer — the actively maintained sysadminsmedia fork at homebox.software. This server speaks the unified entities API introduced in 0.26. Older instances use a different API (/items, /locations, /labels) and are rejected on the first tool call with a clear error rather than failing cryptically.
VariableDescriptionRequired
HOMEBOX_URLEndpoint or connection string the server talks to.Yes
HOMEBOX_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Homebox to Edit.”
  • “Use Homebox to Reporting.”
  • “Use Homebox to Attachments.”

Frequently asked questions

Homebox home inventory: search, intake, warranties, attachments, locations, tags, QR labels Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.