moysklad-mcp server
MCP server for MoySklad — warehouse, inventory, orders, reports (Russia)
6 stars86 downloads/wk
Reviews
Write oneNobody has reviewed moysklad-mcp yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
moysklad-mcp tools (21, 9 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
create_counterpartywrite actionCreate a new counterparty. Set companyType to 'legal', 'entrepreneur', or 'individual'.
create_customer_orderwrite actionCreate a customer order. Prices in RUBLES (converted to kopecks).
create_demandwrite actionCreate a shipment (demand) to fulfill a customer order. Links to a warehouse.
create_productwrite actionCreate a new product. Prices in RUBLES (converted to kopecks internally).
create_supplywrite actionCreate an incoming supply (purchase receipt). Prices in RUBLES.
create_webhookwrite actionRegister a new webhook for entity events (CREATE/UPDATE/DELETE).
get_counterpartiesSearch counterparties (customers/suppliers) by name, INN, or phone.
get_counterpartyGet full details of a counterparty by UUID.
get_customer_orderwrite actionGet a single customer order by UUID with expanded positions.
get_ordersGet customer orders with filtering and sorting. Sums in RUBLES.
get_productGet a single product by UUID. Prices returned in RUBLES.
get_profit_reportGet profit report by product. Shows sales, costs, returns, profit, margin.
get_sales_reportGet sales report by product. Shows quantities sold and revenue.
get_stockGet current stock/inventory report. Shows quantities, reserves, and in-transit.
get_stock_by_storeGet stock report broken down by warehouse/store. Shows how much of each product is in each store.
list_organizationsList all organizations (your legal entities) with names, INN, and meta hrefs.
list_storesList all warehouses/stores with names, addresses, and meta hrefs.
list_webhooksList all registered webhooks with URL, action, entity type, and status.
search_productsSearch products in MoySklad by name or article. Prices returned in RUBLES.
update_customer_order_statuswrite actionChange the status/state of a customer order.
update_priceswrite actionUpdate sale/buy/min prices for a product. Prices in RUBLES.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan27 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 22 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
Install moysklad-mcp in Claude Code, Cursor or VS Code
Runs npx -y @theyahia/moysklad-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcp
What the publisher says
From the moysklad-mcp repository's README, as published. We do not edit it. Read it on GitHub
MCP-сервер для МойСклад — 60 инструментов для ИИ-агента: товары, склад, заказы, финансы
Если вы искали, как подключить МойСклад к Claude или другому ИИ-агенту, — этот сервер закрывает весь торгово-складской цикл через JSON API 1.2: каталог и цены, остатки по складам, контрагенты, заказы покупателей и поставщикам, отгрузки, приёмки, перемещения, инвентаризации, списания, возвраты, счета, платежи и касса, отчёты по прибыли и оборотам, аудит и вебхуки. Спрашиваете «сколько футболок свободно к продаже» или «какая маржа по каждому товару за август» — получаете таблицу с цифрами, а не выгрузку в Excel. Цены во всех инструментах в рублях (перевод в копейки, которых требует API МойСклад, сервер делает сам), лимит запросов соблюдается автоматически.
Часть WWmcp — набора MCP-серверов для развивающихся рынков.
Быстрый старт
Claude Desktop
Добавьте в claudedesktopconfig.json:
{
"mcpServers": {
"moysklad": {
"command": "npx",
"args": ["-y", "@theyahia/moysklad-mcp"],
"env": {
"MOYSKLAD_TOKEN": "your-bearer-token"
}
}
}
}Чтобы использовать логин и пароль вместо токена, замените блок env на:
"env": { "MOYSKLAD_LOGIN": "you@example.com", "MOYSKLAD_PASSWORD": "your-password" }Claude Code
claude mcp add moysklad --env MOYSKLAD_TOKEN=your-bearer-token -- npx -y @theyahia/moysklad-mcpCursor / Windsurf
Добавьте в настройки MCP:
{
"moysklad": {
"command": "npx",
"args": ["-y", "@theyahia/moysklad-mcp"],
"env": { "MOYSKLAD_TOKEN": "your-bearer-token" }
}
}Авторизация
Токен выдаётся в МоёмСкладе: Настройки → Пользователи → Токены доступа (также работает POST /security/token с Basic-авторизацией). Генерация нового токена отзывает предыдущий.
Нужные права: у пользователя или токена должен быть доступ к тем сущностям, с которыми вы работаете. Читающим инструментам нужны права просмотра, создающим и изменяющим — права редактирования соответствующего типа документов. Вебхуки и часть отчётов требуют платного тарифа МойСклад.
Цены
API МойСклад хранит деньги в копейках (1 рубль = 100 копеек). Сервер конвертирует автоматически:
- На вход: передавайте цены и суммы в рублях (например, 1500.50)
- На выход: цены и суммы возвращаются в рублях
- (Отчёт get_dashboard проксируется как есть, поэтому денежные значения в нём остаются в копейках.)
Если у товара есть цена продажи, МойСклад требует тип цены. Сервер сам подставляет тип цены по умолчанию из вашего аккаунта (берёт из listpricetypes); чтобы выбрать конкретный, передайте pricetypehref.
Инструменты (60)
Товары и каталог
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
moysklad-mcp: common questions
- Is moysklad-mcp server safe?
- Yes, by our scan: it is graded A (89/100). Read the moysklad-mcp safety report
- How do I install moysklad-mcp?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does moysklad-mcp need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is moysklad-mcp maintained?
- The last commit was 22 days ago (2026-09-06). The latest release is v3.0.1.
- What can I use instead of moysklad-mcp?
- Servers from other publishers that do the same job: Shopware MCP server, Vtex MCP server and Shopify Admin MCP server. Compare all moysklad-mcp alternatives.
Alternatives to moysklad-mcp
Same job from other publishers: the closest match first, then the best rated.
- ShopwareQuery and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.not reviewedEstablishedB
- not reviewedEstablishedB
Shopify AdminManage products, orders, customers, inventory, and store configurationnot reviewedGrowingB- Polymarket ToolkitRead-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.not reviewedEstablishedB
- Sv NumberPhone numbers for AI agents: order a private number, read the SMS verification code, hand it back.not reviewedEstablishedB