moysklad-mcp-ru
MCP server for the MoySklad JSON API 1.2: stock, orders, profit reports and document creation behind two safety gates
Install
uvx moysklad-mcp-ruRuns from PyPI without installing. Check with moysklad-mcp-ru doctor.
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent direct MoySklad account access without a browser. Typed tools read stock, products, orders, counterparties, documents and profit, turnover and cash reports, with amounts in rubles. Meta-tools cover the rest of the API: search a method in a catalog built from the official docs, describe it and call it. Writing documents such as receipts, shipments, invoices and returns is off by default: documents are created as drafts, and posting or deleting needs a separate confirmation. Several accounts are supported with switching from chat.
Who it is for. Business owners, warehouse staff and accountants keeping records in MoySklad.
Good fit when
- You need stock levels and what to reorder
- You need a per-product profit report for a month
- You need counterparties who owe money
- You need a draft receipt or purchase order
Not a fit when
- You have no test account and want writes enabled on live records right away
- You need an accountant replacement rather than an operations helper
Example request
Show stock at the main warehouse and what to reorder, then pull per-product profit for last monthLimitations
The project is alpha. Requires a MoySklad access token. Methods imported from the docs are verified only by path; write request bodies should be checked against the docs. The author recommends enabling writes only on a test account. The active account in the local store overrides environment variables, a common cause of 401 errors.
How to disable. Remove the server from your client config or uninstall the moysklad-mcp-ru plugin via /plugin. Tokens live in ~/.moysklad-mcp/cabinets.json; revoke them in MoySklad settings.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| MOYSKLAD_ALLOW_WRITE | Enables writes, off by default |
| MOYSKLAD_WRITE_CABINETS | Restricts writes to listed accounts |
Security check
- With writes enabled it creates, posts and deletes documents that move stock and money
- Stores access tokens for several companies' records
README in short
The Russian README, with an English version, covers typed and meta tools, the method catalog built from MoySklad docs, and a safety model split into read, write and destructive operations. It offers several install paths: ask the agent via the bundled install skill, run the double-click installer, use install.py for a specific client, or uvx. It explains kopeck to ruble conversion, API rate limits and alpha caveats. Plugin manifests exist for Claude Code, Codex and Cursor, plus a Gemini CLI extension. MIT license.
FAQ
How do I enable document creation?
Set MOYSKLAD_ALLOW_WRITE=1, optionally limit accounts with MOYSKLAD_WRITE_CABINETS, and pass confirm_write on each call. Posting and deletion need one more confirmation flag.
Where do I get a token?
In MoySklad user settings under access tokens. The server stores it locally in ~/.moysklad-mcp/cabinets.json.
Related
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Skills and an MCP server for options traders: quotes, technical analysis, Greeks, spreads, scanners and Interactive Brokers portfolio
Square MCP Server
Square Model Context Protocol Server
Official Square MCP server: the agent calls any Square API method, from catalog and customers to orders and payments
A CLI and skill giving an agent access to a T-Investments account: portfolio, returns, bond screeners and confirmed orders