# moysklad-mcp

Connects AI coding assistants to the MoySklad ERP via JSON API 1.2 to inspect inventory, manage customer orders, and issue warehouse documents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: theYahia
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/theYahia/moysklad-mcp
- Updated: 2026-09-06
- HTML: https://affpapa.org/en/nevibecode/mcp/moysklad-mcp

## What it does

This server exposes 60 tools to handle sales and warehouse operations through JSON API 1.2. The assistant can look up catalog items, inspect stock levels, and generate customer orders. It respects MoySklad rate limits on its own.

Money values are handled in rubles. You do not need to convert figures into kopecks manually, because the server handles that conversion behind the scenes. Only the `get_dashboard` report returns raw API kopecks. When adding a product, the server automatically assigns your account's default price type.

Authentication relies on `MOYSKLAD_TOKEN` or a login and password pair. Be aware that creating a new token in MoySklad revokes the previous one immediately. Accessing webhooks and specific reporting endpoints also requires an active paid MoySklad tier.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add moysklad-mcp -- npx -y @theyahia/moysklad-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "moysklad-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/moysklad-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "moysklad-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/moysklad-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add moysklad-mcp npx -y @theyahia/moysklad-mcp
```

## When to use it
- check real-time warehouse stock and reserved quantities
- create customer orders and supplier purchase orders
- generate supply, shipment, or stock transfer records
- search counterparties by tax ID or phone number

## Example prompts
- Check available stock and reserved quantities for SKU 1042.
- Create a customer order for counterpart Vector LLC with two catalog items.
- Update the purchase and retail prices for product UUID 550e8400.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md