MoySklad MCP
moysklad-mcp
MoySklad MCP server with 60 tools: products, stock, orders, shipments, receipts, payments, profit reports
Install
claude mcp add moysklad --env MOYSKLAD_TOKEN=your-bearer-token -- npx -y @theyahia/moysklad-mcpThis is third-party code. Review the repository files before installing.
What it does
The server covers the trade and warehouse cycle through MoySklad JSON API 1.2. The agent searches products and counterparties, checks stock by warehouse, creates customer and supplier orders, shipments, receipts, transfers, inventories, write-offs and returns. It also handles invoices, incoming and outgoing payments, cash orders, profit, sales and turnover reports, the audit log and webhooks. Prices are passed in rubles; the server converts to kopecks and respects rate limits. The repo ships eight Claude Code skills for common warehouse tasks.
Who it is for. Store owners, warehouse staff and accountants who keep records in MoySklad.
Good fit when
- You need stock and reserves for a product without an Excel export
- You need to create a customer order and shipment from a short description
- You need a product margin report for a period
Not a fit when
- The agent cannot be trusted with payments and warehouse documents without review
- You need webhooks and extended reports on the free MoySklad plan
Example request
Show products with less than 10 units in stock and their prices, then build a profit report for this monthLimitations
Needs a MoySklad access token or login and password; user permissions limit what operations are available. Issuing a new token revokes the previous one. Webhooks and some reports require a paid plan. The get_dashboard report keeps amounts in kopecks. The default rate limiter is conservative because the API may temporarily block access after repeated 429 errors.
How to disable. Run claude mcp remove moysklad or delete the moysklad block from the client config, then revoke the token in MoySklad.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| MOYSKLAD_TOKEN secret | MoySklad bearer token; required unless login and password are set |
| MOYSKLAD_LOGIN | Login for Basic auth |
| MOYSKLAD_PASSWORD secret | Password for Basic auth |
| MOYSKLAD_RATE_BUCKET | Requests allowed per three-second window, default 20 |
| MOYSKLAD_MAX_CONCURRENT | Maximum concurrent requests, default 5 |
| MOYSKLAD_HTTP_CORS_ORIGIN | Allowed CORS origin for HTTP mode |
Security check
- Creates payments, cash orders and invoices in a live account
- Creates warehouse documents and changes prices
- The token grants access to all of the MoySklad user's data
README in short
The Russian README gives configs for Claude Desktop, Claude Code, Cursor and Windsurf and explains token or login and password auth. Tools are grouped into products, stock, counterparties, orders, warehouse documents, finance, reports, references and webhooks. It covers environment variables, MoySklad rate limits, common errors and fixes. The server is part of the WWmcp series. MIT license.
FAQ
Where do I get a token?
In MoySklad under Settings, Users, Access tokens. A new token revokes the old one.
Can I connect over HTTP?
Yes, running with HTTP_PORT=3000 or --http 3000 exposes POST /mcp and GET /health. CORS is off by default.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
E-Commerce Skills
E-Commerce Skills by Nexscope
A large set of text skills for Amazon, Shopify, eBay, Etsy, TikTok Shop and Walmart sellers: pricing, listings, ads and growth
153 cross-border e-commerce skills via the LinkFox API: Amazon, Ozon, TikTok Shop, 1688, keywords, ads and patents
An MCP server for Bitrix24 CRM contacts and deals via an inbound webhook: search, lists and deal stage changes