Integration · E-commerce

Connect Claude & ChatGPT to BoxHero

Ask your AI how many units are left of an item, where it is stored, or to record goods coming in. In BoxHero it can list items and stock per location, record stock in, out, moves and adjustments, and create, receive and fulfill purchase and sales orders. It can also manage suppliers, customers and returns.

Connect BoxHero free

Free plan, no credit card. Takes about a minute.

Try asking

“How many of SKU TS-BLK-M do we have, and where?”
The AI gets the item by SKU and shows the stock at each location.
“We just received 50 black mugs at the main warehouse.”
It records a Stock In for the item at that location.
“Move 20 units of SKU TS-BLK-M from the warehouse to the shop.”
It records a stock move between the two locations.

What your AI can do

Items and stock

List items with stock per location, create and update items, and record stock in, out, moves and adjustments.

Sales and purchase orders

Create and update orders, receive purchase orders, fulfill sales orders and set sales order status.

Partners and returns

List, create and update suppliers and customers, and create and list sales returns.

“Create a purchase order to Nordic Supply for 200 tote bags.”
It finds the supplier and the item and creates the purchase order, as a draft if you prefer.
“Purchase order 1043 arrived in full at the warehouse.”
It receives the purchase order at that location and adds the stock.
“Which sales orders are still in progress?”
It lists sales orders with the status in-progress, with customer and order number.

28 tools for BoxHero

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_itemChanges dataCreate an item with `name` and optional sku, barcode, cost, price, attributes, photo and starting quantity at a location_id.
create_partnerChanges dataCreate a partner with `name` and `type` (supplier or customer), plus email, phone, address and memo.
create_purchase_orderChanges dataCreate a purchase order with `items`, optional partner_id (supplier), location_id, order_number, costs and dates. `is_draft` keeps it as a draft.
create_returnChanges dataCreate a sales return with `items`, optionally linked to an `order_id` and a `location_id`.
create_sales_orderChanges dataCreate a sales order with `items`, optional partner_id (customer), location_id, order_number, costs and dates. `is_draft` keeps it as a draft.
fulfill_sales_orderChanges dataShip stock for a sales order: `order_id`, `location_id` and the fulfilled `items` with quantities. Removes the stock from that location.
get_itemGet one item by `product_id`, with stock per location (optionally only `location_ids`).
get_item_by_skuGet one item by its `sku`, with stock per location.
get_partnerGet one partner by `partner_id`.
get_purchase_orderGet one purchase order by `order_id`.
get_sales_orderGet one sales order by `order_id`.
get_stock_movementGet one stock transaction by `tx_id`.
list_item_attributesList the custom item attributes defined in the team.
list_itemsList inventory items with their stock quantities, optionally filtered by `item_ids` or `location_ids`. Paginated with `cursor`.
list_locationsList stock locations (warehouses, stores). Use to find a `location_id`.
list_partnersList partners (suppliers and customers), optionally by `type`.
list_purchase_ordersList purchase orders, filtered by `statuses`, `partner_id`, `order_number` or date ranges. Paginated.
list_returnsList sales returns, filtered by `statuses`, `order_id`, `partner_id` or date range. Paginated.
list_sales_ordersList sales orders, filtered by `statuses`, `partner_id`, `order_number` or date ranges. Paginated.
list_stock_movementsList stock transactions, optionally by `type`: in, out, move or adjust. Paginated with `cursor`.
list_team_membersList the members of the BoxHero team.
receive_purchase_orderChanges dataReceive stock for a purchase order: `order_id`, `location_id` and the received `items` with quantities. Adds the stock to that location.
record_stock_movementChanges dataRecord a stock change: `type` (in, out, move or adjust) and `items` (item_id or item_sku with quantity; negative for Stock Out), plus locations, partner and memo as needed. Changes on-hand stock.
set_sales_order_statusChanges dataSet a sales order's `status` (draft, confirmed, in-progress or done) by `order_id`.
update_itemChanges dataUpdate an item by `product_id` (name, sku, barcode, cost, price, attributes). Does not change stock; use record_stock_movement for that.
update_partnerChanges dataUpdate a partner by `partner_id` (the `name` is required).
update_purchase_orderChanges dataUpdate a purchase order by `order_id` (items, partner, dates, costs, memo).
update_sales_orderChanges dataUpdate a sales order by `order_id` (items, partner, dates, costs, memo).

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose BoxHero from the app list.
2
Paste your key
Paste a BoxHero API token. In the BoxHero app go to Settings > Integrations and issue an API token. Each token is bound to one team.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in BoxHero?

The AI can list items, stock per location, locations, stock transactions, sales and purchase orders, returns, partners, item attributes and team members. It can create and update items, partners and orders, record stock in, out, moves and adjustments, receive purchase orders, fulfill sales orders, set sales order status and create returns.

Does the AI see my BoxHero API token?

No. Your BoxHero credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Recording stock movements, receiving purchase orders and fulfilling sales orders change your on-hand stock, and they can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own BoxHero account.

Can I connect more than one BoxHero team?

Each BoxHero API token is bound to a single team, so the AI works in the team the token was issued in. For another team, issue a token in that team.