MoySklad MCP (RU)

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ilyautov-moysklad-mcp-ru

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

12 read · 2 write · 2 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (16)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• ms_build_documentMoySklad build a role document (preview, no write)read-only

  PREVIEW any role document: resolve names to refs and show the EXACT body ms_create_document would send (money already kopecks). READS only; no write. Args: doc_type: one of demand | supply | purchaseorder | invoiceout | invoicein | salesreturn | purchasereturn. agent: counterparty name — supplier for supply/invoicein/purchasereturn/ purchaseorder, customer for demand/invoiceout/salesreturn. organization: own legal entity; omit to auto-use the only one on the cabinet. store: warehouse name. supply/demand move stock, so a store is expected; optional for t…

• ms_build_purchaseorderMoySklad build purchase order (preview, no write)read-only

  PREVIEW a purchase order: resolve names to refs and show the EXACT body ms_create_purchaseorder would send (money already kopecks). Performs READS to resolve names; sends NO write. Inspect the body/summary before creating. Args: agent: supplier counterparty name (поставщик) — required. organization: own legal entity; omit to auto-use the only one on the cabinet. store: warehouse name (optional). positions: list of {"product": name, "quantity": n, "price": rubles, optional "discount" %, "vat" %}. moment/name/description: optional fields. moment is "YYYY-MM-DD HH:MM:…

• ms_create_documentMoySklad create a role document (draft)

  Create ANY role document as a DRAFT (applicable=false — not posted, moves nothing). WRITE — requires confirm_write=true AND MOYSKLAD_ALLOW_WRITE=1. Posting is a separate destructive step (ms_post_document). One body shape fits every order-like document (live-verified 2026-06-26 on all 6 types). Args: doc_type: one of demand | supply | purchaseorder | invoiceout | invoicein | salesreturn | purchasereturn. agent / organization / store / positions / moment / name / description: same as ms_build_document. confirm_write: required (write gate). Returns the created docume…

• ms_create_purchaseorderMoySklad create purchase order (draft)

  Create a purchase order as a DRAFT (applicable=false — not posted, moves nothing). WRITE — requires confirm_write=true. Posting is separate (ms_post_document). Writes also require MOYSKLAD_ALLOW_WRITE=1 (off by default). Args: same as ms_build_purchaseorder, plus confirm_write. Returns the created document envelope {"ok": true, "data": {... "id" ...}}, or the guard/gate error (nothing sent).

• ms_delete_documentMoySklad delete a documentcan change or delete data

  DELETE a document — e.g. remove a test draft to clean up. DESTRUCTIVE — requires both confirmations. Args: doc_type: one of demand|supply|purchaseorder|invoiceout|invoicein| salesreturn|purchasereturn. doc_id: document id. Returns {"ok": true, "status": 200} on success, or the guard/gate error.

• ms_get_counterpartiesMoySklad counterpartiesread-only

  Counterparties (customers and suppliers). Balance fields in kopecks. Args: limit/offset: pagination. filter: MoySklad filter (e.g. "name~ООО"). rubles: convert kopeck balance fields to rubles (default true). Returns JSON: {"ok": true, "data": {"meta", "rows": [ counterparties ]}}.

• ms_get_documentsMoySklad role documents (read)read-only

  List a role document by type. Document total in "sum" (kopecks). Args: doc_type: one of demand | supply | purchaseorder | invoiceout | invoicein | salesreturn | purchasereturn. limit/offset: pagination. filter: MoySklad filter (e.g. "moment>=2026-06-01 00:00:00"). rubles: convert "sum" and money fields to rubles (default true). Returns JSON: {"ok": true, "data": {"meta", "rows": [ documents ]}}.

• ms_get_moneyMoySklad cash balances by accountread-only

  Cash balances by account/cashbox (kopecks). For cashflow over time use ms_call_method('ms_get_report_money_plotseries', ...) from the map. Args: rubles: convert kopeck balances to rubles (default true). Returns JSON: {"ok": true, "data": {"meta", "rows": [ {account, balance, ...} ]}}.

• ms_get_ordersMoySklad customer ordersread-only

  List customer orders. Document total is "sum" (kopecks in raw API). Args: limit: page size, max 1000. offset: pagination offset. filter: optional MoySklad filter (e.g. "moment>=2026-06-01 00:00:00"). rubles: convert "sum" and money fields to rubles (default true). Returns JSON: {"ok": true, "data": {"meta", "rows": [ orders ]}}.

• ms_get_productsMoySklad products (assortment)read-only

  List products/services/bundles (assortment) with prices and stock. Args: limit: page size, max 1000. offset: pagination offset. filter: optional MoySklad filter expression (e.g. "archived=false"). rubles: convert kopeck money fields to rubles (default true). Returns JSON: {"ok": true, "data": {"meta", "rows": [ products ]}}. Sale prices and buy price are kopecks in the raw API; rubles=true converts them.

• ms_get_profitMoySklad profitability by productread-only

  Profitability by product (sale, cost, profit, margin). Money in kopecks. Args: moment_from / moment_to: period bounds "YYYY-MM-DD HH:MM:SS" (report needs them). limit/offset: pagination (rows under "rows"). rubles: kopecks→rubles (default true). Returns JSON: {"ok": true, "data": {"meta", "rows": [ ... ]}}.

• ms_get_stockMoySklad current stockread-only

  Current stock snapshot, grouped by product (fast /report/stock/all/current). Args: stock_type: quantity | freeStock | reserve | inTransit | stock. Default quantity. include_zero: include zero-stock lines (adds include=zeroLines). Returns JSON: {"ok": true, "data": [ {assortmentId, <stock_type>}, ... ]}. No money in this report, so values are returned as-is (quantities).

• ms_get_storesMoySklad warehousesread-only

  Warehouses/stores (small dictionary). No money fields. Returns JSON: {"ok": true, "data": {"meta", "rows": [ {name, id, ...} ]}}.

• ms_get_turnoverMoySklad turnover by productread-only

  Turnover by product: opening/income/outcome/closing in qty and money (kopecks). Args: moment_from / moment_to: period bounds "YYYY-MM-DD HH:MM:SS" (required by the report). limit/offset: pagination. rubles: kopecks→rubles (default true). Returns JSON: {"ok": true, "data": {"meta", "rows": [ ... ]}}.

• ms_pingMoySklad live auth checkread-only

  Live connectivity + auth check: GET assortment?limit=1. Returns {"ok": true, "status": 200, "data": {...}} when the token works, or the canonical error envelope (auth/forbidden/network/...) otherwise. Use this on the cabinet to confirm the token before anything else.

Signals

Stars

2

Forks

0

Open issues

0

Weekly downloads

65

Last commit

Oct 7, 2026 (25 days ago)

Last release

Sep 14, 2026 (1 month ago)

Last package publish

Sep 14, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.ilyautov/moysklad-mcp-ru

Version

0.2.0

Auth

API key

Packages

pypi moysklad-mcp-ru

License

MIT

Repository

github.com/ilyautov/moysklad-mcp-ru

Website

moysklad-mcp-ru.aifrontier.tech

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql