io.github.dgahagan/homebox-mcp MCP Server

Name: io.github.dgahagan/homebox-mcp MCP Server
Author: io.github.dgahagan

io.github.dgahagan/homebox-mcp

Repository Registry

What is the io.github.dgahagan/homebox-mcp MCP server?

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

How to install io.github.dgahagan/homebox-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

HOMEBOX_URL
required
Base URL of your Homebox instance (>= 0.26), e.g. https://homebox.example.com
HOMEBOX_TOKEN
required
secret
Homebox API key (Profile -> API Keys, starts with hb_)
HOMEBOX_ALIAS_FIELD
Optional: name of one custom field treated as a stable item identifier for lookups
HOMEBOX_LABEL_DIR
Optional: directory where label/QR PNGs are saved (default: current directory)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "homebox-mcp": {
      "command": "uvx",
      "args": [
        "homebox-mcp"
      ],
      "env": {
        "HOMEBOX_URL": "<YOUR_HOMEBOX_URL>",
        "HOMEBOX_TOKEN": "<YOUR_HOMEBOX_TOKEN>",
        "HOMEBOX_ALIAS_FIELD": "<YOUR_HOMEBOX_ALIAS_FIELD>",
        "HOMEBOX_LABEL_DIR": "<YOUR_HOMEBOX_LABEL_DIR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "homebox-mcp": {
      "command": "uvx",
      "args": [
        "homebox-mcp"
      ],
      "env": {
        "HOMEBOX_URL": "<YOUR_HOMEBOX_URL>",
        "HOMEBOX_TOKEN": "<YOUR_HOMEBOX_TOKEN>",
        "HOMEBOX_ALIAS_FIELD": "<YOUR_HOMEBOX_ALIAS_FIELD>",
        "HOMEBOX_LABEL_DIR": "<YOUR_HOMEBOX_LABEL_DIR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "homebox-mcp": {
      "command": "uvx",
      "args": [
        "homebox-mcp"
      ],
      "env": {
        "HOMEBOX_URL": "<YOUR_HOMEBOX_URL>",
        "HOMEBOX_TOKEN": "<YOUR_HOMEBOX_TOKEN>",
        "HOMEBOX_ALIAS_FIELD": "<YOUR_HOMEBOX_ALIAS_FIELD>",
        "HOMEBOX_LABEL_DIR": "<YOUR_HOMEBOX_LABEL_DIR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "homebox-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "homebox-mcp"
      ],
      "env": {
        "HOMEBOX_URL": "<YOUR_HOMEBOX_URL>",
        "HOMEBOX_TOKEN": "<YOUR_HOMEBOX_TOKEN>",
        "HOMEBOX_ALIAS_FIELD": "<YOUR_HOMEBOX_ALIAS_FIELD>",
        "HOMEBOX_LABEL_DIR": "<YOUR_HOMEBOX_LABEL_DIR>"
      }
    }
  }
}

Claude Code

claude mcp add homebox-mcp --env HOMEBOX_URL=<YOUR_HOMEBOX_URL> --env HOMEBOX_TOKEN=<YOUR_HOMEBOX_TOKEN> --env HOMEBOX_ALIAS_FIELD=<YOUR_HOMEBOX_ALIAS_FIELD> --env HOMEBOX_LABEL_DIR=<YOUR_HOMEBOX_LABEL_DIR> -- uvx homebox-mcp

Related MCP servers

Weather Data MCP Server

17 weather tools, no API keys: forecasts, alerts, air quality, marine, radar, lightning, wildfires