RetailCRM MCP
retailcrm-mcp
RetailCRM MCP server: orders, customers, products, stock, payments, tasks and store analytics via API v5
- 1 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Creates and changes orders, customers and payments in a live CRM
- Customer merges and payment deletion are irreversible
- Handles shoppers' personal data
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/retailcrm-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Creates and changes orders, customers and payments in a live CRM
- Customer merges and payment deletion are irreversible
- Handles shoppers' personal data
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent 39 tools on top of RetailCRM API v5. The agent searches and creates orders and customers, changes statuses and delivery, reads change history, warehouse stock, segments, costs and reference lists. Payments can be created, edited and deleted, and duplicate customers merged. Responses default to a compact field summary; detail or raw returns more. RETAILCRM_READONLY keeps only the read tools.
Who it is for. For online stores on RetailCRM that want answers about orders and customers without manual reports.
Good fit when
- You need the status, items and payment of an order by number
- You need an order and revenue summary for a day or period
- You need to check stock of an item across warehouses
Not a fit when
- You need webhooks: RetailCRM cannot create them via API, use admin triggers instead
- The agent must not change orders or payments and you will not enable read-only mode
Example request
Show today's orders in status new with total revenueMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
RETAILCRM_DOMAINrequired- Account domain, e.g. yourstore.retailcrm.ru
RETAILCRM_API_KEYrequired, secret- API key from the Integration section
RETAILCRM_READONLY- 1 keeps only read tools
RETAILCRM_RATE_LIMIT- Client-side requests per second limit
Limitations
Requires a RetailCRM API key with rights to the sections you use; multi-site keys need the site code passed explicitly. Version 3 returns summaries instead of raw JSON by default; use raw:true for the old format. merge_customers and order_payment_delete are irreversible. RetailCRM allows about 10 requests per second.
How to disable. Remove the retailcrm block from the MCP client config and revoke the API key in RetailCRM settings.
FAQ
How do I stop the agent from changing data?
Set RETAILCRM_READONLY=1 to hide the create, update, merge and delete tools.
Where do I get a key?
In RetailCRM under Settings, Integration, API keys, where you also choose its permissions.
Discussion
No questions or reviews yet.
Related
All RetailCRM toolsRetailCRM MCP server
RetailCRM MCP Server
A RetailCRM MCP server with one-click Railway or Render deploy: orders, customers, products, statistics and reference data
RetailCRM MCP on the official PHP client
retailcrm-mcp
44 tools and 2 prompt skills for RetailCRM built on the official PHP client: orders, customers, inventory, payments, tasks and PII-free analytics
RetailCRM plugin for Codex and Claude Code
RetailCRM plugin
The RetailCRM plugin: a remote GraphQL MCP server plus a skill that safely searches the schema and confirms mutations with the user
A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data
embed-ui for RetailCRM extensions
@retailcrm/embed-ui
RetailCRM's official CLI and package set for interface extensions: project scaffolding, UI components, data contexts and ready MCP setup for agents
MoySklad MCP
moysklad-mcp
MoySklad MCP server with 60 tools: products, stock, orders, shipments, receipts, payments, profit reports
README in short
The README lists 39 tools by group: orders, customers, products and stock, payments, notes and tasks, marketing, files, reference lists and analytics, plus two prompts. It covers response detail options, getting a key, environment variables, Claude Desktop config, Streamable HTTP mode and Smithery install. There are demo prompts, a webhooks note and retry-based error handling. Part of the WWmcp series, MIT license.