# KiotViet MCP by usefulapi

> KiotViet MCP by usefulapi is an MCP server. Read KiotViet products, customers, invoices, orders and stock; create customers and orders. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read KiotViet products, customers, invoices, orders and stock; create customers and orders.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `kiotviet_list_products`: List products (code, barcode, name, category, base price, units, attributes). Optionally include stock per branch (include_inventory) and price-book prices. Filter by name, category, branch, active flag or last change. GET /products.
- `kiotviet_get_product`: One product by id: code, barcode, name, category, base price, units, attributes, images, stock per branch and price books. GET /products/{id}.
- `kiotviet_get_product_by_code`: One product by its product code (SKU). GET /products/code/{code}.
- `kiotviet_list_categories`: List product categories (id, name, parent, whether it has children). Set hierarchical to get the category tree. GET /categories.
- `kiotviet_get_category`: One product category by id (name, parent, children). GET /categories/{id}.
- `kiotviet_list_customers`: List customers (code, name, phone, email, address, debt, total invoiced, reward points, groups). Contains personal data of the shop's customers. Filter by code, name, phone, group or last change. GET /customers.
- `kiotviet_get_customer`: One customer by id: contact data, debt, total invoiced, reward points, groups. GET /customers/{id}.
- `kiotviet_get_customer_by_code`: One customer by customer code. GET /customers/code/{code}.
- `kiotviet_create_customer`: WRITE: create a new customer in the shop (name required; code is generated by KiotViet if omitted). Always check with the user first, and look the customer up by phone before creating a duplicate. POST /customers.
- `kiotviet_list_invoices`: List sales invoices (code, date, branch, customer, total, amount paid, status, lines). Filter by branch, customer, status, order, purchase-date range or last change. GET /invoices.
- `kiotviet_get_invoice`: One invoice by id with its lines, payments and delivery. GET /invoices/{id}.
- `kiotviet_get_invoice_by_code`: One invoice by invoice code (for example HD000123). GET /invoices/code/{code}.
- `kiotviet_list_orders`: List sales orders (code, date, branch, customer, total, status, lines, delivery). Filter by branch, customer, status, creation date (from) or last change (from/to). GET /orders.
- `kiotviet_get_order`: One sales order by id with its lines, payments and delivery. GET /orders/{id}.
- `kiotviet_get_order_by_code`: One sales order by order code (for example DH000123). GET /orders/code/{code}.
- `kiotviet_create_order`: WRITE: create a sales order (an order, not an invoice: no invoice is made and no payment is recorded) with lines of existing products in a branch, for an existing customer or none. Always confirm the products, quantities and prices with the user first. POST /orders.
- `kiotviet_list_branches`: List the shop's branches (id, name, code, phone, address). Use the ids to filter other tools. GET /branches.
- `kiotviet_list_stock`: Stock on hand and reserved quantity per product and branch. Filter by branch or last change. GET /productOnHands.
- `kiotviet_list_suppliers`: List suppliers (code, name, phone, email, address, debt, total invoiced). Filter by code, name, phone or last change. GET /suppliers.
- `kiotviet_get_supplier`: One supplier by id. GET /suppliers/{id}.
- `kiotviet_list_purchase_orders`: List goods receipts from suppliers (nhap hang: code, date, branch, supplier, total, lines). Filter by branch, status or purchase-date range. GET /purchaseorders.
- `kiotviet_get_purchase_order`: One goods receipt (nhap hang) by id with its lines. GET /purchaseorders/{id}.
- `kiotviet_list_supplier_orders`: List orders placed with suppliers (dat hang nhap: code, date, branch, supplier, status, lines, amount paid). Filter by branch, status, supplier or product text. GET /ordersuppliers.
- `kiotviet_list_returns`: List customer returns (code, date, branch, customer, invoice, return total, lines). GET /returns.
- `kiotviet_get_return`: One customer return by id with its lines. GET /returns/{id}.
- `kiotviet_list_cashflow`: List cash-book entries (receipts and payments: code, branch, method, partner, amount, date, status). Filter by branch, direction or date range. GET /cashflow.
- `kiotviet_list_users`: List the shop's staff users (id, username, name, phone, email). GET /users.
- `kiotviet_list_price_books`: List price books (bang gia: name, active flag, validity dates, branches, customer groups). GET /pricebooks.
- `kiotviet_get_price_book`: The product prices of one price book (product id, code, price), paged. GET /pricebooks/{id}.

## FAQ

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

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

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