🧾 Kash MCP Server

Kash MCP Server is the official Model Context Protocol (MCP) server for Kash — a free, cloud-based POS, invoicing, CRM and webshop platform trusted by thousands of merchants since 2011.

Connect your Kash account to Claude, ChatGPT, n8n, or any MCP-compatible AI — and manage your entire business through natural conversation.

🟢 Hosted server: https://mcp.kash.click
📖 Full documentation: kash.click/cash-register-software

✨ What you can do

Just talk. No menus, no clicks.

Code

"Record a sale of 2 coffees and 1 croissant at table 84"
"Show me this week's revenue report"
"Add a new item called Summer Tart at €4.50 in the Pastries department"
"Who are my best customers this month?"
"Create a Kash account for my restaurant"
"Record the card payment for order #1042"
"Add a Large size option to the Size variation"

🚀 Features

🔐 Account & Authentication — no config required

Create a new Kash account directly from the conversation
List accounts linked to an email to check if one already exists
Login via OTP — a one-time password is sent to your email, no password needed
Logout to clear the session at any time

🧾 Sales & Orders

Record sales with catalog items, department lines, or free lines
Edit orders — add items, assign a client, record payments, validate as invoice
List orders by date range, validated or unvalidated, filtered by delivery method
Get order details — full breakdown of items, client, payments and totals

📊 Reports

Sales report — HTML summary for any period: a specific day, month, or full year (defaults to yesterday)

📦 Catalog Management

Items (PLU): add, edit, delete — with price, department, VAT, barcode, stock, variations...
Departments: add, edit, delete — with VAT, price, group, variations...
Department groups: add, edit, delete — to organize your catalog
VAT rates: add, edit, delete
Variations: add, edit, delete (e.g. "Size", "Color")
Variation choices: add, edit, delete (e.g. "S", "M", "L" for "Size") with optional price delta

👥 Customer Management (CRM)

Add, edit, delete customers with full contact info, company details, VAT number, barcode, loyalty data, private notes, blacklist status...

📋 Data & Lists

Retrieve any reference data from your shop:

Tool	Data
`data.list.products`	Items / articles
`data.list.departments`	Departments / categories
`data_list_department_groups`	Department groups
`data_list_vats`	VAT rates
`data_list_clients`	Customers
`data_list_variations`	Variation types
`data_list_payments`	Payment methods
`data_list_cashboxes`	Cashboxes
`data_list_delivery_men`	Delivery methods
`data_list_delivery_zones`	Delivery zones
`data_list_relay_points`	Relay / pickup points
`data_list_discounts`	Discounts & supplements
`data.list.users`	Staff / users
`data_list_tables`	Tables (restaurant mode)
`data.list.orders`	Orders by date range

🛠 Available Tools (46)

Category	Tools
Account	`account.list`, `account.create`
Auth	`auth.request.otp`, `auth.login.with_otp`, `auth.logout`
Sales	`order.create`, `order.edit`, `order.detail`, `data.list.orders`, `data.list.pending_orders`
Reports	`report.get`
Items	`plu_add`, `plu_edit`, `plu_delete`, `data.list.products`
Departments	`dept_add`, `dept_edit`, `dept_delete`, `data.list.departments`
Dept groups	`dept_group_add`, `dept_group_edit`, `dept_group_delete`, `data_list_department_groups`
VAT	`vat_add`, `vat_edit`, `vat_delete`, `data_list_vats`
Variations	`variation_add`, `variation_edit`, `variation_delete`, `data_list_variations`
Variation choices	`variation_choice_add`, `variation_choice_edit`, `variation_choice_delete`
Customers	`client_add`, `client_edit`, `client_delete`, `data_list_clients`
Data	`data_list_payments`, `data_list_cashboxes`, `data_list_delivery_men`, `data_list_delivery_zones`, `data_list_relay_points`, `data_list_discounts`, `data.list.users`, `data_list_tables`
Utility	`ping`

⚙️ Prerequisites

You need a Kash / free-cash-register.net account.

Don't have one? You can create it directly from the conversation using account.create, or register at kash.click/free-pos-software.

Already have one? Retrieve your APIKEY and SHOPID in the software under Setup → Webservices or connect using oAuth.

🔌 Option 1 — Hosted server (recommended)

The easiest way: connect directly to the hosted MCP server at https://mcp.kash.click/mcp.

No installation needed. Authentication is handled via OAuth 2.0 with PKCE.

Claude.ai

In Settings → Integrations, add a new connector:

Field	Value
Name	`Kash`
MCP Server URL	`https://mcp.kash.click/mcp`
Authentication	`OAuth`

ChatGPT

In Settings → Connectors → Create Connector:

Field	Value
Name	`Kash POS`
MCP Server URL	`https://mcp.kash.click/mcp`
Authentication	`OAuth`

Smithery

Available on smithery.ai — search for Kash.

💻 Option 2 — Self-hosted (STDIO)

Run the server locally for Claude Desktop or any STDIO-based MCP client.

Quick start via npx

Terminal

npx caisse-enregistreuse-mcp-server --shopid=YOUR_SHOPID --apikey=YOUR_APIKEY

Claude Desktop configuration

Edit claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

config.json

{
  "mcpServers": {
    "kash": {
      "command": "npx",
      "args": [
        "caisse-enregistreuse-mcp-server",
        "--shopid=YOUR_SHOPID",
        "--apikey=YOUR_APIKEY"
      ]
    }
  }
}

Or using environment variables:

config.json

{
  "mcpServers": {
    "kash": {
      "command": "node",
      "args": ["PATH_TO_BUILD/build/stdio.js"],
      "cwd": "PATH_TO_BUILD",
      "env": {
        "SHOPID": "YOUR_SHOPID",
        "APIKEY": "YOUR_APIKEY"
      }
    }
  }
}

Install from source

bash

# 1) Clone
git clone https://github.com/paracetamol951/caisse-enregistreuse-mcp-server.git
cd caisse-enregistreuse-mcp-server

# 2) Install dependencies
npm install

# 3) Create .env
echo "SHOPID=YOUR_SHOPID" > .env
echo "APIKEY=YOUR_APIKEY" >> .env

# 4) Build
npm run build

# 5) Run
node build/stdio.js

Docker (HTTP mode)

HTTP mode requires Redis. Use Docker Compose:

Terminal

docker compose up

Or run manually:

Terminal

docker run -d -p 6379:6379 redis
npm run dev

🔐 Authentication flow

Hosted server (OAuth)

Authentication is handled automatically by the OAuth 2.0 + PKCE flow when you connect through Claude.ai, ChatGPT, or Smithery.

In-conversation authentication (OTP)

You can also authenticate directly within the conversation — no password required:

Code

1. auth.request.otp(email)         → OTP sent to your inbox
2. auth.login.with_otp(email, otp) → session initialized ✓
3. auth.logout()                   → clear session when done

If you don't have an account yet:

Code

1. account.list(email)             → check existing accounts
2. account.create(email, title)    → create + session auto-initialized ✓

STDIO / self-hosted

Pass credentials via CLI args or environment variables — SHOPID and APIKEY.

📡 API endpoints

Endpoint	Description
`POST https://mcp.kash.click/mcp`	MCP JSON-RPC endpoint
`GET https://mcp.kash.click/health`	Health check → `{ "status": "ok" }`
`GET https://mcp.kash.click/.well-known/mcp/manifest.json`	MCP manifest (tool list)
`GET https://mcp.kash.click/.well-known/openid-configuration`	OAuth discovery

🌍 Internationalization

Tool titles and descriptions are available in English and French, resolved automatically from the Accept-Language header or the MCP_LANG environment variable.

Locale files: locales/en/common.json, locales/fr/common.json

Demo credentials

If you want to try the tool without creating an account, you can use the following credentials

💻 Compatible clients

Client	Mode
Claude.ai	HTTP / OAuth
Claude Desktop	STDIO
ChatGPT	HTTP / OAuth
n8n	HTTP
Flowise / LangChain	HTTP
Smithery	HTTP / OAuth
Any MCP client	STDIO or HTTP

🏪 Supported business types

When creating an account with account.create, use configType to pre-load a dataset tailored to your business:

Bar · Bakery · Restaurant · Fast-food · Cafe · Coffee-shop · Pizzeria · Brewery · Food-truck · Snack · Florist · Retail · Pharmacy · Supermarket · Clothing-store · Ecommerce · Services · Beauty-institute · Coiffeur · Market · Library · Camping · and more...

🔗 Links

🌐 Website: kash.click
📖 Documentation: kash.click/cash-register-software
🔧 API Reference: kash.click/cash-register-software/mcp
🆓 Register for free: kash.click/free-pos-software

Caisse Enregistreuse MCP Server README

🧾 Kash MCP Server

✨ What you can do

🚀 Features

🔐 Account & Authentication — no config required

🧾 Sales & Orders

📊 Reports

📦 Catalog Management

👥 Customer Management (CRM)

📋 Data & Lists

🛠 Available Tools (46)

⚙️ Prerequisites

🔌 Option 1 — Hosted server (recommended)

Claude.ai

ChatGPT

Smithery

💻 Option 2 — Self-hosted (STDIO)

Quick start via npx

Claude Desktop configuration

Install from source

Docker (HTTP mode)

🔐 Authentication flow

Hosted server (OAuth)

In-conversation authentication (OTP)

STDIO / self-hosted

📡 API endpoints

🌍 Internationalization

Demo credentials

💻 Compatible clients

🏪 Supported business types

🔗 Links

📋 License