Boxhero MCP server

Connect Boxhero to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Boxhero MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list items tool in Boxhero
  • Use the list attributes tool in Boxhero
  • Use the create transaction tool in Boxhero
  • Use the list locations tool in Boxhero
  • Use the list transactions tool in Boxhero
  • Use the get team tool in Boxhero

Supported Tools

list_items

List Items

Retrieve inventory items from BoxHero. Supports filtering by location and pagination for large inventories. Returns item details including name, SKU, barcode, cost, price, and custom attributes.

list_attributes

List Attributes

Retrieve custom attribute definitions from BoxHero. Attributes are additional metadata fields (e.g., Category, Expiration Date, Safety Stock) that can be attached to items. Supported types include text, number, date, and barcode.

create_transaction

Create Transaction

Create an inventory transaction in BoxHero. Supports all four transaction types: - **Stock In**: Record items entering inventory (requires destination location for Location mode) - **Stock Out**: Record items leaving inventory (uses toLocationId for the stock location; legacy fromLocationId is also accepted) - **Adjust Stock**: Correct inventory quantities (use a relative signed quantity change) - **Move Stock**: Transfer items between locations (requires both source and destination locations) Optionally attach a partner (supplier for Stock In, customer for Stock Out) and a memo.

list_locations

List Locations

Retrieve all inventory locations (warehouses, stores, stockrooms) from BoxHero. Use location IDs when filtering items or creating transactions.

list_transactions

List Transactions

Retrieve inventory transactions from BoxHero. Requires a team in Location mode. Supports filtering by transaction type (in, out, adjust, move) and pagination.

get_team

Get Team

Retrieve the BoxHero team linked to the current API token. Returns the team ID, name, and operating mode (0 = Basic, 1 = Unit, 2 = Location). Useful for determining which transaction endpoints and features are available.

list_partners

List Partners

Retrieve suppliers and customers from BoxHero. Partners are linked to inventory transactions — suppliers for Stock In and customers for Stock Out. Use partner IDs when creating transactions.

get_transaction

Get Transaction

Retrieve one inventory transaction with full line items and its revision for safe updates or deletion. Call list_transactions to discover transaction IDs.

get_item

Get Item

Retrieve one inventory item by ID with custom attributes and per-location stock. Call list_items to discover item IDs.

manage_item

Manage Item

Create, partially update, or delete an inventory item. Use list_items or get_item to discover and inspect items; list_attributes provides custom attribute IDs. Stock changes after creation use create_transaction.

manage_transaction

Manage Transaction

Partially update or delete an inventory transaction. Call get_transaction first and pass its latest revision to detect concurrent edits. Updates may replace all line items; transaction type cannot be changed.

Connect Boxhero to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Boxhero in Metorial. In your Metorial portal, enable the Boxhero MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Boxhero tools.

Run Boxhero through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Boxhero and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Boxhero tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Boxhero

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Apaleo

Manage hotel and serviced apartment operations through a cloud-based property management system (PMS). Create, modify, cancel, and manage reservations and bookings, including check-in, check-out, no-show handling, and room assignments. Manage property inventory including units (rooms), unit groups (room types), and unit attributes. Set up and update rate plans, rates, restrictions, and availability in real-time. Handle guest folios by posting charges, payments, refunds, and allowances, and move items between folios. Create, cancel, and render invoices as PDFs. Process payments via terminals and pay-by-link, manage payment authorizations, and track transaction lifecycles including settlements, refunds, and disputes. Manage company profiles for corporate bookings. Handle group bookings and room blocks with confirmation, release, and wash operations. Subscribe to ARI (Availability, Rates, Inventory) change notifications for channel distribution. Configure property settings, services, and city taxes. Trigger night audit operations. Manage account users. Retrieve reports and accounting transaction data.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Shopify

Manage e-commerce stores including products, orders, customers, inventory, and fulfillment. Create and update products with variants, images, and metafields. Process and track orders, draft orders, refunds, and transactions. Manage customer records, addresses, and marketing consent. Track and adjust inventory levels across multiple locations. Handle fulfillment workflows including routing to warehouses and third-party logistics. Create and manage discount codes, price rules, and automatic discounts. Configure shipping rates, carrier services, and delivery profiles. Build custom storefronts with cart management and checkout via the Storefront API. Manage content including pages, blogs, articles, and themes. Support B2B commerce with company profiles, catalogs, and custom pricing. Receive webhooks for events across orders, products, customers, inventory, fulfillment, collections, carts, checkouts, disputes, and more.

Technical notes for Boxhero

Manage BoxHero inventory items, track stock across locations, and create, inspect, update, or delete stock transactions. Discover your team, custom attributes, and supplier/customer partners.

Frequently asked questions

Common questions about connecting Boxhero to AI agents with Metorial.

  1. How many tools does the Boxhero MCP server have?
    The Boxhero MCP server exposes 11 tools, including List Items, List Attributes, Create Transaction. Each one is governed and traced through Metorial.
  2. Boxhero exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Boxhero MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Boxhero and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Boxhero MCP server yourself or use the hosted gateway.

Connect Boxhero to production AI agents

See how Metorial gives your team governed access to Boxhero, with tracing and security controls built in.