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 connecting e-commerce tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-07-06 · ★ 2 · #24 OF 39 MAINTAINED E-COMMERCE · VERIFIED 2026-08-25

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

repo age created 2026-07-04 - young repo, little track record yet

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.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…

v0.9.1 · 2026-07-06

Registry listing release. · Added · server.json + mcp-name marker in the README for the official MCP registry listing (registry ownership validation reads the PyPI README).

v0.9.0 · 2026-07-06

First public release: the personal Homebox MCP server generalized for anyone's instance, packaged for PyPI. · Breaking · create_item: personal named params (item_id, category, dossier, resale_value, value_asof…

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

category
e-commerce - ranked #24 of 39 actively-maintained e-commerce servers as of 2026-08-25.
release cadence
3 releases in the last 90 days (latest 2026-07-06)
registry
io.github.dgahagan/homebox-mcp (active, first published 2026-07-04 · 2 versions)
packages
pypi:homebox-mcp

06 · Homebox MCP FAQ

What is 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…

Is Homebox MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-06 and it shipped 3 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