🧾 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.

"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:

🛠 Available Tools (46)

⚙️ 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:

ChatGPT

In Settings → Connectors → Create Connector:

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

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

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

Or using environment variables:

{
  "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

# 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:

docker compose up

Or run manually:

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:

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:

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

🌍 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

Login: Demo15 Password : demodemo

💻 Compatible clients

🏪 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

📋 License

© 2025 Net-assembly. GNU General Public License v3.0