Homebox MCP

An MCP server over the Homebox REST API, so an MCP client like Claude can work with your home inventory in plain language: "where is my impact driver", "what's in Tote B-3", "which warranties expire this year", "add this drill - here's a photo of the receipt and the model number". It answers questions, performs intake (create an item, attach the manual/receipt, tag and file it), manages attachments, and prints QR…

People who work with home inventory, homebox and self hosted and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-16 · ★ 6 · #13 OF 52 MAINTAINED E-COMMERCE · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Homebox MCP

before you install - you'll need

Set HOMEBOX_URL, HOMEBOX_TOKEN before connecting.

Claude Code

claude mcp add dgahagan-homebox-mcp -- uvx homebox-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "dgahagan-homebox-mcp": {
      "command": "uvx",
      "args": [
        "homebox-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package homebox-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.dgahagan is GitHub-verified and matches the repo owner

03 · What Homebox MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.1.0 · 2026-09-16

Migrates to the mcp 2.x SDK. Closes #2, the follow-up from the 1.0.1 hotfix. · The tool surface does not move · Every registered tool was dumped by wire alias under mcp 1.x, 2.0.0 and 2.2.0 and diffed. All three are…

v1.0.1 · 2026-09-16

Patch release fixing a total install break for new users. · Fixed · uvx homebox-mcp crashed on startup with: · No module named 'mcp.server.fastmcp' · 1.0.0 declared mcp>=1.10 with no upper bound. mcp 2.0.0 shipped…

v1.0.0 · 2026-07-06

1.0 🎉 - maintenance log, reporting, sold lifecycle, and a leaner tool surface for context-constrained MCP clients. · Breaking - context/tool-surface optimization (see docs/DECISIONS.md) · Removed set_location_manifest…

04 · Who maintains Homebox MCP

homebox-mcp is maintained by dgahagan. It's the only MCP server we track from this author; the repo dates to Jul 2026.

05 · Facts

repository: github.com/dgahagan/homebox-mcp
category: e-commerce - ranked #13 of 52 actively-maintained e-commerce servers as of 2026-09-18.
release cadence: 5 releases in the last 90 days (latest 2026-09-16)
registry: io.github.dgahagan/homebox-mcp (active, first published 2026-07-04 · 4 versions)
packages: pypi:homebox-mcp

06 · Homebox MCP FAQ

What is Homebox MCP?

Is Homebox MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-16 and it shipped 5 releases in the last 90 days. We re-verify nightly.

How do I install Homebox MCP?

Run `uvx homebox-mcp`. The README documents 2 environment variables (HOMEBOX_URL, HOMEBOX_TOKEN) to set first. Set HOMEBOX_URL, HOMEBOX_TOKEN before connecting. You can also paste the ready-made client config above.

Does Homebox MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Homebox MCP

Alternatives to Homebox MCP

Maintained e-commerce servers if Homebox MCP isn't the fit.

More e-commerce MCP servers · Good Barber · HasData Amazon · Авито MCP (RU) · Marketplaces MCP (RU) - Wildberries, Ozon, Yandex Market, Avito

More Python MCP servers · Chain Weaver · Contextweaver (dgenio) · Edgar Tools · Tripitaka MCP · Forensic Deepdive · see all