@theyahia/moysklad-mcp

MCP server for MoySklad (МойСклад) warehouse and CRM management API. 21 tools covering the full order lifecycle: products, stock, counterparties, customer orders, shipments, supplies, warehouses, organizations, reports, and webhooks.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "moysklad": {
      "command": "npx",
      "args": ["-y", "@theyahia/moysklad-mcp"],
      "env": {
        "MOYSKLAD_TOKEN": "your-bearer-token"
      }
    }
  }
}

Claude Code

claude mcp add moysklad -- npx -y @theyahia/moysklad-mcp

Set env: MOYSKLAD_TOKEN or both MOYSKLAD_LOGIN + MOYSKLAD_PASSWORD.

Cursor / Windsurf

Add to MCP settings:

{
  "moysklad": {
    "command": "npx",
    "args": ["-y", "@theyahia/moysklad-mcp"],
    "env": {
      "MOYSKLAD_TOKEN": "your-bearer-token"
    }
  }
}

Tools (21)

Products

Stock

Counterparties

Customer Orders

Shipments & Supply

Reference Data

Reports

Webhooks

Prices

The MoySklad API stores all prices in kopecks (1 ruble = 100 kopecks). This MCP server handles the conversion automatically:

• Input: pass prices in rubles (e.g. 1500.50)

• Output: prices are returned in rubles

• Internally: converted to/from kopecks when talking to the API

Auth

Two options:

Get a token in MoySklad: Settings > Users > Access tokens.

HTTP Transport

# Start with Streamable HTTP transport
HTTP_PORT=3000 npx @theyahia/moysklad-mcp
# or
npx @theyahia/moysklad-mcp --http 3000

Endpoints: POST /mcp (JSON-RPC), GET /health (status).

Rate Limiting

Built-in token-bucket rate limiter: 45 requests per 3 seconds (MoySklad API limit). Automatic retry with exponential backoff on 429/5xx errors.

E-commerce Stack

Build a full Russian e-commerce backend with MCP:

Part of the russian-mcp series.

Demo Prompts

Inventory check:

"Show me all products with low stock (less than 10 units) and their current prices"

Order workflow:

"Create a customer order for counterparty 'OOO Roga i Kopyta' with 50 units of 'Widget Pro' at 1500 rubles each, then create a shipment from the main warehouse"

Sales analytics:

"Pull the profit report and tell me which products have the highest margin this month"

Development

npm install
npm run build
npm test

API Reference

Based on MoySklad API v1.2.

License

MIT