SkillFoxx

RetailCRM MCP server

RetailCRM MCP Server

A RetailCRM MCP server with one-click Railway or Render deploy: orders, customers, products, statistics and reference data

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

Broad access

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
All reasons and checks
Russian stack

aryazansev/retailcrm-mcpAuthor:aryazansev

Install

Services

Manual install

npm install -g retailcrm-mcp

Global install before setting up .env and claude_desktop_config.json.

Access and checks

How we review

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

  • 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

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.com

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

Limitations

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.

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.

Discussion

No questions or reviews yet.

All RetailCRM tools

RetailCRM MCP

retailcrm-mcp

Russian stack

RetailCRM MCP server: orders, customers, products, stock, payments, tasks and store analytics via API v5

MCP serverBroad access2
Russian stack

44 tools and 2 prompt skills for RetailCRM built on the official PHP client: orders, customers, inventory, payments, tasks and PII-free analytics

MCP serverBroad access
Official

RetailCRM plugin for Claude Code and Codex: a remote MCP server with GraphQL access to the CRM and a skill with safe-use rules

PluginBroad access3
Russian stack

The RetailCRM plugin: a remote GraphQL MCP server plus a skill that safely searches the schema and confirms mutations with the user

PluginBroad access
Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access38
Official

RetailCRM's official CLI and package set for interface extensions: project scaffolding, UI components, data contexts and ready MCP setup for agents

CLIExtended access1

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.

README badge

Report a problem