# Hiboutik MCP by usefulapi

> Hiboutik MCP by usefulapi is an MCP server. Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/hiboutik/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/hiboutik
- **MCP Registry name:** io.usefulapi/hiboutik
- **Listing updated:** 2026-11-13

## About

Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hiboutik https://hiboutik.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://hiboutik.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hiboutik": {
      "url": "https://hiboutik.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hiboutik": {
      "type": "http",
      "url": "https://hiboutik.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hiboutik": {
      "serverUrl": "https://hiboutik.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hiboutik": {
      "type": "http",
      "url": "https://hiboutik.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `hiboutik_list_stores`: List the shops (stores) of the account: id, name, warehouse id, currency, time zone, address. Use store ids for sales, payment types and reports. GET /stores.
- `hiboutik_list_warehouses`: List warehouses (stock locations) with id and name. Use the ids for stock levels. GET /warehouses.
- `hiboutik_list_users`: List the Hiboutik users (staff, sales vendors): id, name, email, access level. The id is the vendor_id of a sale. Passwords and keys are never returned. GET /users.
- `hiboutik_list_taxes`: List the tax (VAT) rates with id, name, value and default flag. GET /taxes.
- `hiboutik_list_payment_types`: List the payment types enabled in a store (cash, card, cheque...) with currency and flags. GET /payment_types/{store_id}/.
- `hiboutik_list_categories`: List product categories (newest id first) with parent id and flags. GET /categories.
- `hiboutik_list_brands`: List product brands (newest id first). GET /brands.
- `hiboutik_list_suppliers`: List the suppliers with id, name and contact details. GET /suppliers/.
- `hiboutik_list_size_types`: List the variant (size) types, such as clothing sizes or colours. Use an id with hiboutik_list_sizes. GET /size_types.
- `hiboutik_list_sizes`: List the variants (sizes) of one variant type: size_id and name. The size_id identifies a variant of a product in stock and sales. GET /sizes/{size_type_id}.
- `hiboutik_list_products`: List products (default newest id first) with model, barcode, price, supply price, brand, category, supplier and stock management flag. 250 per page. GET /products/.
- `hiboutik_get_product`: One product with its full details. GET /products/{product_id}.
- `hiboutik_search_products_by_name`: Find products whose model (name) matches the text. GET /products/search/name/{q}.
- `hiboutik_find_product_by_barcode`: Find the product (and variant) with this barcode. GET /products/search/barcode/{barcode}/.
- `hiboutik_search_products`: Search products by model, category, brand, supplier, archived state, supplier or external reference. GET /products/search/.
- `hiboutik_stock_all_warehouses`: Available stock per product and variant across warehouses, optionally filtered by category, brand, supplier or archived state. GET /stock_available/all_wh.
- `hiboutik_stock_by_warehouse`: Available stock per product and variant in one warehouse, optionally filtered. GET /stock_available/warehouse_id/{warehouse_id}.
- `hiboutik_stock_by_product`: Available stock of one product per variant and warehouse, with the inventory alert level. GET /stock_available/product_id/{product_id}.
- `hiboutik_list_stock_orders`: List the stock orders / goods receipts. GET /inventory_inputs/.
- `hiboutik_list_customers`: List customers (newest id first) with name, email, phone, country, loyalty points and store credit. Personal data of the shop's customers. GET /customers/.
- `hiboutik_search_customers`: Search customers by last name, first name, email, phone, VAT number, country, customer code or external reference (each text value needs at least 3 characters). Dates: yyyy-mm-dd, or prefix with > < >= <= to compare. GET /customers/search/.
- `hiboutik_get_customer`: One customer with full details. GET /customer/{customers_id}.
- `hiboutik_list_customer_sales`: List the sales made to one customer (newest first). GET /customer/{customers_id}/sales/.
- `hiboutik_get_sale`: One sale with its header, totals, payment and line items. GET /sales/{sale_id}.
- `hiboutik_list_open_sales`: List the sales not yet closed in a store (newest first). GET /open_sales/{store_id}.
- `hiboutik_list_closed_sales`: List the closed (completed) sales of a store for one day, or for a whole month when day is omitted. GET /closed_sales/{store_id}/{year}/{month}[/{day}].
- `hiboutik_report_turnover`: Sales total (turnover) of a store for one day, or per day for a whole month when day is omitted. GET /reports/turnover/{store_id}/{year}/{month}[/{day}].
- `hiboutik_report_products_sold`: Products sold in a store during one month: quantities and revenue per product. GET /reports/products/{store_id}/{year}/{month}.
- `hiboutik_create_customer`: WRITE: create a customer in Hiboutik. Needs at least a last name, first name, company or email. Returns the new customer id. POST /customers/.
- `hiboutik_update_customer`: WRITE: change ONE attribute of a customer (it overwrites the current value). Attributes: gender (0 unknown, 1 male, 2 female), last_name, first_name, email, company, phone, vat, country, date_of_birth, customers_code, comments, validity, customers_ref_ext, customers_misc. PUT /customer/{customers_id}/.
- `hiboutik_set_sale_comment`: WRITE: add or replace the comment of a sale (it overwrites any existing comment). POST /sales/comments/.

## FAQ

### How do I add Hiboutik MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http hiboutik https://hiboutik.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/hiboutik-mcp-by-usefulapi
