SkillFoxx

MoySklad for Claude Code: read and write on API 1.2

claude-moysklad-mcp

A local Python and FastMCP connector for MoySklad products, stock, counterparties and customer orders plus a raw request to any API method

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Creates and changes orders and documents and can delete data through `api_request`
  • The MoySklad token gives its user rights over products, stock and counterparties
All reasons and checks
Russian stack

stepan-cloud/claude-moysklad-mcpAuthor:stepan-cloud

Install

Services

Manual install

git clone https://github.com/stepan-cloud/claude-moysklad-mcp
cd claude-moysklad-mcp
python setup.py

The README command: the installer creates an environment and registers the `moysklad` connector in `~/.claude.json`.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Creates and changes orders and documents and can delete data through `api_request`
  • The MoySklad token gives its user rights over products, stock and counterparties

This is third-party code. Review the repository files before installing.

What it does

A local Python and FastMCP server opens the MoySklad JSON API 1.2 to Claude Code. It finds products, variants, services and bundles by name, code, article or barcode, returns stock for all warehouses or each warehouse with filters such as below the minimum balance, and reads counterparties, orders and documents. A customer order is created from plain data: a counterparty by name or tax id, items by code or article, prices in roubles. There are twelve tools in all: reading entities and positions, creating and changing any objects, bulk creation up to 1000 at a time and `api_request` for reports, statuses and deletion. Lists come back as a `header` and `rows` table that can be written to a Google Sheet in one call. The token goes only to `api.moysklad.ru`.

Who it is for. Owners of small shops and warehouse staff on MoySklad who want to ask for stock, find a counterparty or place an order from a chat.

Good fit when

  • You need stock by warehouse and the items below the minimum balance
  • A customer order is created from a message: counterparty by tax id, positions by article, prices in roubles
  • Stock has to be exported as a table and written to a Google Sheet
  • A one-off report or document status has no ready tool and a raw request is used

Not a fit when

  • You want read-only work: the token carries user rights and the connector can create and change documents
  • The environment has no Python 3.10 or no right to create a virtual environment
  • You need a cloud connector in the Connectors panel: this one is local only

Example request

Show products whose warehouse stock is below the minimum balance and export them as a table

MCP

Transport
stdio
Authentication
API key

Limitations

The connector is local, works only in Claude Code and does not show in the Connectors panel, and its status is read with `/mcp`. Installation needs Python 3.10 or newer and a clone that has to stay in place. The token is made by hand in MoySklad and saved by the `authorize.py` script. Amounts in the API are in kopecks and the `:rub` suffix converts them to roubles. The agent is told to confirm with the user before creating or changing documents but nothing technically prevents an edit: deletion is reachable through `api_request`. There are no stars and one author.

How to disable. Run `uninstall.bat` on Windows or delete the `moysklad` entry from `~/.claude.json` and revoke the token in MoySklad settings.

FAQ

How do I get a token?

In MoySklad open Settings, then Tokens and create one. It gets the rights of the user it is made for, so a dedicated employee is safer.

Where is the token saved?

The `authorize.py` script opens a text editor, you paste the token and close the file, and the connection is checked automatically. The token is never requested in chat.

What are the data limits?

A page is read by 1000 rows, 100 with `expand`, and paging then runs by itself. On a 429 reply the connector waits and retries.

What about money in replies?

The API returns amounts in kopecks. The `:rub` suffix on a column converts them to roubles and order prices are set in roubles.

How do I check the install?

Restart Claude Code fully, call `ping` and then `search_assortment` with `max_rows=5`.

Discussion

No questions or reviews yet.

All MoySklad tools

MoySklad MCP

moysklad-mcp

Russian stack

MoySklad MCP server with 60 tools: products, stock, orders, shipments, receipts, payments, profit reports

MCP serverBroad access10
Russian stack

An MCP server for MoySklad: product and stock search, counterparties by INN, creating and reading orders, a sales summary via a single npx package

MCP serverBroad access
Russian stack

A MoySklad MCP server with two write gates: stock, profit, reports and draft documents over JSON API 1.2

MCP serverBroad access
Russian stack

MCP server for the MoySklad JSON API 1.2: stock, orders, profit reports and document creation behind two safety gates

MCP serverBroad access3

MoySklad production MCP server

moysklad-production-mcp

Russian stack

A read-only MCP server for the MoySklad production module: process cards, production tasks and per-product profit

MCP serverExtended access

MoySklad MCP by partner Kaya

MCP-сервер МойСклад (Kaya)

Russian stack

A paid app from the MoySklad marketplace: once installed, an agent searches products, counterparties and orders and creates documents through a chat

MCP serverBroad access

README in short

The README opens with steps for Claude itself to install the connector, then lists capabilities: assortment, stock, counterparties, documents, a raw request and a table mode. Requirements, manual installation and getting a token follow. A separate `CLAUDE.md` repeats the install order and warns about amounts in kopecks and confirming writes.

README badge

Report a problem