RetailCRM MCP server
RetailCRM MCP Server
A RetailCRM MCP server with one-click Railway or Render deploy: orders, customers, products, statistics and reference data
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- The create_order, create_customer and update_customer tools change real orders and customers in the CRM
- There is no read-only mode; grant the key minimal necessary rights and test it on a non-production account
Install
Manual install
npm install -g retailcrm-mcpGlobal install before setting up .env and claude_desktop_config.json.
This is third-party code. Review the repository files before installing.
What it does
A TypeScript server exposes 19 tools on top of the RetailCRM API: reading and creating orders, reading, creating and updating customers, the product catalog, order and customer statistics, reference data for statuses, delivery and payment types, sites, order change history, and tasks. It runs over stdio for Claude Desktop or as an HTTP server with /health, /manifest and /tools endpoints for external clients such as Google AI Studio. The README has one-click Railway and Render deploy buttons, followed by entering a RetailCRM key.
Who it is for. For RetailCRM store owners who want quick MCP access to orders and customers without running their own infrastructure.
Good fit when
- You want a quick RetailCRM MCP deployment on a free host like Railway
- You need both stdio for Claude Desktop and an HTTP manifest for other AI tools
- A basic tool set is enough: orders, customers, products, statistics
Not a fit when
- You need broad API coverage: payments, files, segments, cost tracking are not covered here
- You care about README accuracy: the git clone instructions still have a yourusername placeholder instead of the real repo owner
- You need a read-only mode: there is no READONLY toggle in the README, create and update tools are available right away
Example request
Show the last 10 orders in RetailCRM and create a task to call back the customer at test@example.comLimitations
The README has rough edges: the git clone command points to a placeholder yourusername/retailcrm-mcp instead of this repo's address. There is no read-only mode; the order and customer create/update tools are available right after setting up a single API key. There is no breakdown of the permissions the key needs, beyond a general recommendation to grant read access to orders, customers and products.
How to disable. Remove the retailcrm entry from claude_desktop_config.json, or stop the deployed Railway or Render service.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| RETAILCRM_URL required | RetailCRM account address like https://your-account.retailcrm.ru |
| RETAILCRM_API_KEY required, secret | RetailCRM API access key with rights to the needed sections |
Security check
- The create_order, create_customer and update_customer tools change real orders and customers in the CRM
- There is no read-only mode; grant the key minimal necessary rights and test it on a non-production account
README in short
The Russian README describes one-click Railway or Render deploy, installing via npm install -g or git clone, setting up .env with a RetailCRM URL and key, two connection modes: local Claude Desktop over stdio and an external HTTP server with /health, /manifest, /tools for AI Studio, the tool list grouped by orders, customers, products, reference data and statistics, plus development commands and MCP Inspector testing.
FAQ
Where do I get a RetailCRM API key?
In the RetailCRM panel: Settings, Integration, API access keys. The key needs read access to orders, customers and products, and write access for the create tools.
Can this run outside Claude Desktop?
Yes, npm run server starts an HTTP server with a manifest at /manifest that tools like Google AI Studio can pick up.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail