moysklad-mcp — Claude Code MCP server: what it does, how to install
Connects AI coding assistants to the MoySklad ERP via JSON API 1.2 to inspect inventory, manage customer orders, and issue warehouse documents.
claude mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcpWhat moysklad-mcp does
This server exposes 60 tools to handle sales and warehouse operations through JSON API 1.2. The assistant can look up catalog items, inspect stock levels, and generate customer orders. It respects MoySklad rate limits on its own.
Money values are handled in rubles. You do not need to convert figures into kopecks manually, because the server handles that conversion behind the scenes. Only the get_dashboard report returns raw API kopecks. When adding a product, the server automatically assigns your account's default price type.
Authentication relies on MOYSKLAD_TOKEN or a login and password pair. Be aware that creating a new token in MoySklad revokes the previous one immediately. Accessing webhooks and specific reporting endpoints also requires an active paid MoySklad tier.
What it helps with
- check real-time warehouse stock and reserved quantities
- create customer orders and supplier purchase orders
- generate supply, shipment, or stock transfer records
- search counterparties by tax ID or phone number
Example prompts for the agent
- Check available stock and reserved quantities for SKU 1042.
- Create a customer order for counterpart Vector LLC with two catalog items.
- Update the purchase and retail prices for product UUID 550e8400.
How to install moysklad-mcp
Platform CLI
claude mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcpPlatform CLI
codex mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcpConfig file
{
"mcpServers": {
"moysklad-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/moysklad-mcp"
]
}
}
}Config file
{
"servers": {
"moysklad-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/moysklad-mcp"
]
}
}
}Platform CLI
gemini mcp add moysklad-mcp npx -y @theyahia/moysklad-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about moysklad-mcp
How to install moysklad-mcp in Claude Code?
Run claude mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcp. Supply your Bearer token in the MOYSKLAD_TOKEN environment variable before executing.
What does moysklad-mcp do?
It gives AI assistants 60 tools to interact with MoySklad warehouse, order, and customer records. It handles stock tracking, sales documents, and catalog management via JSON API 1.2.
How does the server handle product pricing?
Input and output values use standard rubles, which the server translates to kopecks for the API. The only exception is get_dashboard, which passes raw kopeck values directly.
