RetailCRM MCP
retailcrm-mcp
RetailCRM MCP server: orders, customers, products, stock, payments, tasks and store analytics via API v5
Install
{
"mcpServers": {
"retailcrm": {
"command": "npx",
"args": ["-y", "@theyahia/retailcrm-mcp"],
"env": {
"RETAILCRM_DOMAIN": "yourstore.retailcrm.ru",
"RETAILCRM_API_KEY": "your-api-key"
}
}
}
}The same snippet works for other clients using the mcpServers format.
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 revenueLimitations
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.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| RETAILCRM_DOMAIN required | Account domain, e.g. yourstore.retailcrm.ru |
| RETAILCRM_API_KEY required, secret | API key from the Integration section |
| RETAILCRM_READONLY | 1 keeps only read tools |
| RETAILCRM_RATE_LIMIT | Client-side requests per second limit |
Security check
- Creates and changes orders, customers and payments in a live CRM
- Customer merges and payment deletion are irreversible
- Handles shoppers' personal data
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.
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.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
E-Commerce Skills
E-Commerce Skills by Nexscope
A large set of text skills for Amazon, Shopify, eBay, Etsy, TikTok Shop and Walmart sellers: pricing, listings, ads and growth
153 cross-border e-commerce skills via the LinkFox API: Amazon, Ozon, TikTok Shop, 1688, keywords, ads and patents
An MCP server for Bitrix24 CRM contacts and deals via an inbound webhook: search, lists and deal stage changes