Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Se ejecuta en la nube
Homebox MCP
What it does
Homebox home inventory: search, intake, warranties, attachments, locations, tags, QR labels
- Connects Se ejecuta en tu computadora
- Account or key Needs HOMEBOX_URL, HOMEBOX_TOKEN
- Category Tiendas en línea y pagos
Instalación
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Instala Python (uv)
Una sola vez; sirve para todos los servidores que necesitan Python (uv)
Regístrate y crea una clave de Homebox MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Pega esta configuración y guarda el archivo
{ "mcpServers": { "homebox": { "command": "uvx", "args": [ "homebox-mcp" ], "env": { "HOMEBOX_URL": "your-value", "HOMEBOX_TOKEN": "your-value", "HOMEBOX_ALIAS_FIELD": "your-value", "HOMEBOX_LABEL_DIR": "your-value" } } } }Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Cierra Claude y vuelve a abrirlo
Pruébalo
Usa Homebox MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Homebox MCP o muestra una herramienta de Homebox MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Homebox MCP
Homebox MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
Lo que puedes hacer en su lugar
A · Usa una app que pueda conectar Homebox MCP
- Necesitas una clave de Homebox MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
- Necesitas una clave de Homebox MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
- Necesitas una clave de Homebox MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
- Necesitas una clave de Homebox MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
B · Otros en Tiendas en línea y pagos que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
- Spree Commerce developer docs for AI agents✓ ChatGPT
- Stripe MCP✓ ChatGPT
- earnrate✓ ChatGPT
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Homebox MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Instala Python (uv)
Una sola vez; sirve para todos los servidores que necesitan Python (uv)
Regístrate y crea una clave de Homebox MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Pega este comando y pulsa Enter
claude mcp add --scope user homebox --env HOMEBOX_URL=your-value --env HOMEBOX_TOKEN=your-value --env HOMEBOX_ALIAS_FIELD=your-value --env HOMEBOX_LABEL_DIR=your-value -- uvx homebox-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Escribe /mcp en Claude Code
Deberías ver Homebox MCP en la lista como conectado
Pruébalo
Usa Homebox MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Homebox MCP o muestra una herramienta de Homebox MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Homebox MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Instala Python (uv)
Una sola vez; sirve para todos los servidores que necesitan Python (uv)
Regístrate y crea una clave de Homebox MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Escribe tu clave
En la configuración de Homebox MCP, HOMEBOX_URL, HOMEBOX_TOKEN, HOMEBOX_ALIAS_FIELD, HOMEBOX_LABEL_DIR está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Abre el chat de IA de Cursor en modo Agent
Pruébalo
Usa Homebox MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Homebox MCP o muestra una herramienta de Homebox MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Homebox MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Instala Python (uv)
Una sola vez; sirve para todos los servidores que necesitan Python (uv)
Regístrate y crea una clave de Homebox MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Escribe tu clave
En la configuración de Homebox MCP, HOMEBOX_URL, HOMEBOX_TOKEN, HOMEBOX_ALIAS_FIELD, HOMEBOX_LABEL_DIR está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Abre el chat de IA de VS Code en modo Agent
Pruébalo
Usa Homebox MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Homebox MCP o muestra una herramienta de Homebox MCP en la respuesta, ya está conectado
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Para desarrolladores: comandos de Terminal y configuración JSON
Instalado en tu computadora
Claude Code
claude mcp add --scope user homebox --env HOMEBOX_URL=your-value --env HOMEBOX_TOKEN=your-value --env HOMEBOX_ALIAS_FIELD=your-value --env HOMEBOX_LABEL_DIR=your-value -- uvx homebox-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"homebox": {
"command": "uvx",
"args": [
"homebox-mcp"
],
"env": {
"HOMEBOX_URL": "your-value",
"HOMEBOX_TOKEN": "your-value",
"HOMEBOX_ALIAS_FIELD": "your-value",
"HOMEBOX_LABEL_DIR": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"homebox": {
"command": "uvx",
"args": [
"homebox-mcp"
],
"env": {
"HOMEBOX_URL": "your-value",
"HOMEBOX_TOKEN": "your-value",
"HOMEBOX_ALIAS_FIELD": "your-value",
"HOMEBOX_LABEL_DIR": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"homebox": {
"type": "stdio",
"command": "uvx",
"args": [
"homebox-mcp"
],
"env": {
"HOMEBOX_URL": "your-value",
"HOMEBOX_TOKEN": "your-value",
"HOMEBOX_ALIAS_FIELD": "your-value",
"HOMEBOX_LABEL_DIR": "your-value"
}
}
}
}Valores que debes completar
HOMEBOX_URLobligatorio envBase URL of your Homebox instance (>= 0.26), e.g. https://homebox.example.comHOMEBOX_TOKENsecreto obligatorio envHomebox API key (Profile -> API Keys, starts with hb_)HOMEBOX_ALIAS_FIELDenvOptional: name of one custom field treated as a stable item identifier for lookupsHOMEBOX_LABEL_DIRenvOptional: directory where label/QR PNGs are saved (default: current directory)
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
De un vistazo
Qué apps pueden usarlo
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 13 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub dgahagan, dueña del repo
- ✓ Superada
Sigue en mantenimiento
Último cambio de código: anteayer
- ✓ Superada
Tiene licencia
Usa MIT
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Conversación
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Reseñas de usuarios
Aún no hay reseñas
Comparado con otros en Tiendas en línea y pagosi
- Más estrellas que el 98% de los otros 2759 servidores de esta categoría
- Publicado en el registro más recientemente que el 88% de los otros 2759 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 100% de los otros 2759 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro Homebox MCP?
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
Debes completar: HOMEBOX_URL, HOMEBOX_TOKEN
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez anteayer, y la última versión (1.5.1) llegó al registro anteayer.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
Otros de la misma categoría
Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Se ejecuta en la nube✓ del servicio · stripe.com
Sessy — Amazon SES observability
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Se ejecuta en la nube
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
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 labels for totes and shelves — no hand-rolled curl.
Quickstart
You need a running Homebox instance (0.26+, see Requirements) and an API key from Profile → API Keys in the Homebox web UI.
Claude Code
claude mcp add homebox --scope user \-e HOMEBOX_URL=https://homebox.example.com \ -e HOMEBOX_TOKEN=hb_xxxxxxxxxxxxxxxxxxxxxxxx \ -- uvx homebox-mcp claude mcp get homebox # should show: Status ✔ Connected
--scope user makes it available from any project. uvx fetches and runs the published package in an ephemeral environment — nothing to install first.
Claude Desktop / generic MCP clients
Add to your client's MCP config (e.g. claude_desktop_config.json):
{"mcpServers": { "homebox": { "command": "uvx", "args": ["homebox-mcp"], "env": { "HOMEBOX_URL": "https://homebox.example.com", "HOMEBOX_TOKEN": "hb_xxxxxxxxxxxxxxxxxxxxxxxx" } } } }
From a clone (no PyPI)
The module carries PEP 723 inline dependencies, so it also runs standalone with uv run --script — uv resolves mcp, httpx, pillow, and pillow-heif into an ephemeral venv on first run. Instead of env vars, drop credentials in a .env file next to the module:
git clone https://github.com/dgahagan/homebox-mcpcd homebox-mcp cp .env.example .env # .env is gitignored chmod 600 .env
edit .env: HOMEBOX_URL + HOMEBOX_TOKEN
Then register the absolute path to the module (or to server.py, a compatibility shim kept for older registrations):
claude mcp add homebox --scope user -- \uv run --script /path/to/homebox-mcp/homebox_mcp.py
The server reads config from the environment, falling back to the sibling .env (resolved relative to the script, so the absolute-path invocation still finds it). The credential never enters the MCP config — it stays in the gitignored .env.
Requirements
- 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. - An API key — Homebox Profile → API Keys (the token starts with
hb_). - [`uv`](https://docs.astral.sh/uv/), or any Python ≥ 3.11 environment where you install
homebox-mcpyourself. - MCP SDK 2.x (
mcp>=2,<3), pulled in automatically.uvx/pipxbuild an isolated environment, so this needs no action. If you are installing into an environment already pinned tomcp<2, stay onhomebox-mcp==1.0.1.
Configuration
All configuration is via environment variables (or the sibling .env for the clone workflow):
| Variable | Required | Purpose |
|---|---|---|
HOMEBOX_URL | yes | Base URL of your Homebox instance (no trailing slash). |
HOMEBOX_TOKEN | yes | Homebox API key (hb_…). |
HOMEBOX_ALIAS_FIELD | no | Name of one custom field to treat as a stable item identifier — items can be resolved by it, summaries surface it, and field_index defaults to it. Unset = resolve by assetId/name only. See Conventions. |
HOMEBOX_LABEL_DIR | no | Where generate_label / qrcode save output. Default: current working directory. |
Tools
~39 tools. Reads accept a fuzzy identifier (assetId, alias field, exact name, then first keyword match). Write tools require an exact identifier (assetId, alias field, or exact name) — a typo or an ambiguous match is refused rather than mutating the wrong item. An assetId must be in the full 000-012 form: a bare 12 is matched as a name or alias, never as asset 000-012. Locations are referenced by name or /-separated path (e.g. Garage/Shelf 1) to disambiguate duplicate names.
Read / Q&A
| Tool | Purpose |
|---|---|
search_items(query?, tags?, limit=20) | Search items by keyword and/or tag names (AND of both); returns each with assetId, location, and the alias field. |
get_item(identifier) | Full detail for one item: location path, identity, purchase, warranty, custom fields, tags, attachments. |
list_locations() | The full location tree as an indented outline. |
location_contents(location, recursive=False) | Items directly in a location plus its sub-location names; recursive=True walks the whole subtree and returns every nested item with its full location path. |
list_tags(detail=False) | All tag (label) names; detail=True returns full objects (description, color, icon, parent tag). |
warranties_expiring(before?, after?, lifetime=False) | Items whose warranty expires in after…before (after defaults to today, excluding already-expired); lifetime=True lists lifetime-warranty items. |
Create & intake
| Tool | Purpose |
|---|---|
create_item(name, location?, quantity=1, manufacturer?, model?, serial?, purchase_price?, purchase_date?, purchase_from?, warranty_expires?, notes?, fields?, tags?) | Create and enrich an item in one call. fields is a dict typed by JSON value (string→text, number→number [integer-coerced], bool→boolean); tags must already exist. location resolves as in move_item: a location name or path, or a container item (name, path or assetId). Returns the new assetId. |
import_csv(csv_text) | Bulk-create items and locations from a Homebox CSV in one multipart request. HB.location auto-creates the path hierarchy; recognizes HB.name, HB.tags, HB.quantity, HB.serial_number, HB.model_number, HB.manufacturer, HB.notes, HB.purchase_*, HB.warranty_expires, HB.field. . |
create_location(name, parent?, description?) | Create a location (tote/bin/shelf) to bootstrap a new storage spot; description doubles as a contents manifest. |
barcode_lookup(code) | UPC/EAN → name/manufacturer/model (optional, for boxed goods). |
duplicate_item(identifier, copy_attachments=False, copy_custom_fields=True, copy_maintenance=False, prefix="Copy of ") | Duplicate an item ("I bought a second one"). Copied custom fields include the alias field verbatim — give the copy its own value after. |
Edit
All write tools resolve by exact identifier and preserve everything you don't touch (a full-body PUT that echoes the rest of the item back — see gotchas).
| Tool | Purpose |
|---|---|
set_item(identifier, new_name?, description?, notes?, quantity?, purchase_price?, purchase_date?, purchase_from?, insured?, archived?, fields?) | General item editor: rename, notes, quantity, purchase info, insured/archived flags, custom fields. Quantity-only edits use a partial PATCH. |
move_item(identifier, location) | Move an item into a location or into another item (e.g. a lens into Camera Bag). The destination is a location name or path, as before; only if no location matches is it looked up as an item by exact name or path (e.g. Office/Camera Bag), or give the item's assetId. A name matching more than one is refused, and so is a location as the item to move — use set_location (partial PATCH — nothing else changes). |
set_warranty(identifier, expires?, lifetime?, details?) | Set warranty end date, lifetime flag, and terms summary. |
set_identity(identifier, manufacturer?, model_number?, serial_number?) | Set manufacturer / model / serial (e.g. after a nameplate photo reveals them). |
set_fields(identifier, fields) | Create or overwrite custom fields (upsert; typed by JSON value type). |
set_tags(identifier, tags, mode="add") | Add / remove / replace tags on an item; unknown tag names are auto-created (partial PATCH). |
set_tag(name, new_name?, description?, color?, icon?, parent?, clear_parent=False) | Edit a tag's own metadata (rename, color, icon, parent tag for grouping) — not what's tagged on an item. Creates the tag if new. |
set_location(location, new_name?, parent?, clear_parent?, description?, notes?, tags?, tags_mode?, entity_type?, asset_id?, fields?) | General location editor: rename, move (or clear_parent to root), tags, notes, entity type, assetId, custom fields. |
mark_sold(identifier, sold_price?, sold_to?, sold_date?, sold_notes?, clear=False) | Record a sale (price/buyer/date/notes) or clear=True to un-sell; pair with set_item(archived=True) to retire the item. |
Maintenance log
| Tool | Purpose |
|---|---|
log_maintenance(identifier, name, description?, completed_date?, scheduled_date?, cost?) | Add an entry — "changed the mower oil today" (completed) or "sharpen blades in spring" (scheduled). |
list_maintenance(identifier?, status="both") | Entries for one item, or across the whole inventory ("what maintenance is due?"); status = scheduled / completed / both. |
set_maintenance(entry_id, ...) | Edit an entry — e.g. mark a scheduled one completed by setting completed_date. |
delete_maintenance(entry_id, confirm) | Delete one entry (confirm = its exact name). |
Reporting
| Tool | Purpose |
|---|---|
inventory_stats(by="totals", start?, end?) | Totals (counts, total value, warranty count), value by location or tag, or purchase-price over time — the cheap way to answer "what's my inventory worth?". |
export_csv(save_to?) | Export the whole inventory as a Homebox CSV (complement of import_csv; quick backup). |
list_custom_fields(field?) | Discover the custom-field schema in use: all field names, or every distinct value of one field. |
Attachments
| Tool | Purpose |
|---|---|
attach_document(identifier, source, title, doc_type="manual", primary=False) | Attach a file (local path or http(s) URL) to an item, or to a location by name as a fallback. doc_type e.g. manual/receipt/warranty/photo; primary=True makes a photo the entity's primary image (e.g. a location's "this is the spot" wayfinding shot). |
list_attachments(identifier) | List an item's or location's attachments with their ids (the handle the other attachment tools need). |
get_attachment(identifier, attachment_id, save_to) | Download one attachment to a local path so its content (e.g. a manual) can be read. |
rename_attachment(identifier, attachment_id, title?, doc_type?, primary?) | Update an attachment's title, type, or primary flag. |
Uploads auto-convert HEIC/HEIF (iPhone photos) to JPEG so Homebox always
stores a browser-renderable image, and sanitize
/in titles (Homebox treats
a title as a path and would otherwise truncate it).
Deletes (confirm-gated)
Every delete requires confirm to equal the target's exact name and carries the MCP destructiveHint annotation, so clients prompt before running them.
| Tool | Purpose |
|---|
| delete_item(identifier, confirm) | Permanently delete an item and its attachments. No und