Connect HomeBox to Your AI Agent

Find an item by name or tags and add the details or maintenance record you provide.

18 tools API key

Try a HomeBox Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill HomeBox

Record Item Maintenance

Find the exact item and add a maintenance entry with date, description, and cost.

/oo HomeBox: Find [item name] in HomeBox, read entity [ID], and add maintenance named [name], completed on [date], with description [details] and cost [amount].

Correct Item Details

Read a record and change only the item details you specify.

/oo HomeBox: Read HomeBox entity [ID] and update its manufacturer to [manufacturer] and warranty details to [details], leaving other fields unchanged.

Start Working with HomeBox

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect HomeBox

    Connect your HomeBox instance root URL and an API key from Users > API Keys.

    Connect HomeBox →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A publicly reachable HomeBox instance and a key with the issuing account’s permissions.
  • Hosted connections reject private-network or IPv6 targets and self-signed TLS certificates.

HomeBox Tools

HomeBox exposes inventory entities, types, tags, attachments, and maintenance entries. Updates preserve fields you omit, allowing focused corrections to an existing record.

Inventory Records

Find and maintain inventory entities with their types, parent locations, and tags.

Maintenance and Attachments

Read or add maintenance records and attach a file from a public URL.

18 tools

Get Status

Fetch the HomeBox instance status: health, version, and whether registration is open.

homebox.get_status

List Entities

Search HomeBox entities with optional text search, pagination, and tag or parent filters.

homebox.list_entities

Get Entity

Fetch one HomeBox entity with its full details, including attachments and custom fields.

homebox.get_entity

Create Entity

Create a new HomeBox entity with a name and optional type, parent, description, quantity, and tags.

homebox.create_entity

Update Entity

Update one HomeBox entity while preserving fields that are not provided.

homebox.update_entity

Delete Entity

Delete one HomeBox entity.

homebox.delete_entity

List Entity Types

List all HomeBox entity types, including location-flagged types.

homebox.list_entity_types

Create Entity Type

Create a new HomeBox entity type, optionally flagged as a location.

homebox.create_entity_type

Delete Entity Type

Delete one HomeBox entity type.

homebox.delete_entity_type

List Tags

List all HomeBox tags.

homebox.list_tags

Create Tag

Create a new HomeBox tag.

homebox.create_tag

Delete Tag

Delete one HomeBox tag.

homebox.delete_tag

Get Group Statistics

Fetch HomeBox group dashboard statistics.

homebox.get_group_statistics

Add Entity Attachment

Download a public file URL and attach the file to one HomeBox entity.

homebox.add_entity_attachment

Get Maintenance Log

Fetch the maintenance log of one HomeBox entity.

homebox.get_maintenance_log

Add Maintenance Entry

Add a maintenance entry to one HomeBox entity.

homebox.add_maintenance_entry

List Custom Field Names

List custom field names in use across the HomeBox group.

homebox.list_custom_field_names

List Custom Field Values

List values in use for one custom field name.

homebox.list_custom_field_values

Frequently Asked Questions

How do I identify an item?

Search by text and optionally narrow by tag or parent. Read the selected entity’s details before making a change.

Will a partial update clear other fields?

Fields not supplied are preserved. Provide only the details you want changed, taking care with complete collections such as custom fields.

How can I add a receipt or manual?

Provide the entity ID and a public file URL. The connection downloads the file and adds it as an attachment.

Connect HomeBox

About HomeBox ↗