checkbox-mcp MCP Server

An MCP server for the API of Checkbox, a Ukrainian software cash register (ПРРО). It lets an AI assistant such as Claude answer questions about receipts, shifts, X/Z reports, goods and orders of…

Local serverstdioMIT

What is the checkbox-mcp Server?

checkbox-mcp is an MCP project maintained in the myradostudio/checkbox-mcp repository. The maintainer describes its purpose as “An MCP server for the API of Checkbox, a Ukrainian software cash register (ПРРО). It lets an AI assistant such as Claude answer questions about…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @myradostudio/checkbox-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares CHECKBOX_PIN_CODE, CHECKBOX_LICENSE_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_cashier_profileThe signed-in cashier, permissions, test flag, and the organization
list_cash_registersCash registers with fiscal number, address, online/offline mode, open shift
get_cash_registerOne cash register by id, or the one the license key belongs to
get_offline_statusAvailable offline fiscal codes and time spent offline
get_current_shiftThe open shift of the cashier with its running balance
list_shiftsShifts of the cashier, or of the cash register
get_shiftOne shift in full, including its Z-report once closed
search_receiptsReceipts by period, fiscal number, barcode, shift, cash register, branch
get_receiptOne receipt as JSON, or as printable text
list_reportsX- and Z-reports with totals per payment form
get_reportOne report as JSON, or as printable text
get_periodical_reportThe periodical report for a date range, as text
search_goodsGoods from the Checkbox catalogue with prices and tax rates
list_taxesTax rates configured for the organization
list_ordersOrders (draft receipts placed by an external system)
get_orderOne order in full, including customer delivery details
open_shiftOpens a shift on the cash register of the license key
close_shiftCloses the current shift and creates its Z-report
create_sale_receiptCreates and fiscalizes a sale receipt
create_return_receiptCreates and fiscalizes a return receipt
create_service_receiptPuts cash into the register or takes it out
send_receipt_emailE-mails a copy of a receipt
send_receipt_smsSends a copy of a receipt by SMS/Viber (a Checkbox service billed separately)

How to install the checkbox-mcp Server

{
  "mcpServers": {
    "checkbox": {
      "command": "npx",
      "args": [
        "-y",
        "@myradostudio/checkbox-mcp"
      ],
      "env": {
        "CHECKBOX_PIN_CODE": "your cashier PIN code",
        "CHECKBOX_LICENSE_KEY": "YOUR_CHECKBOX_LICENSE_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
CHECKBOX_PIN_CODEDeclared in the maintainer’s client configuration.Check documentation
CHECKBOX_LICENSE_KEYDeclared in the maintainer’s client configuration.Check documentation