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

  • 0 ★ on the repository
  • Last commit
  • MIT
Plugin

Broad access

Why this level

  • Mutations can change orders, customers, deliveries, payments and conversations in the live RetailCRM account
  • The skill requires confirmation before a mutation, but reads are available to the agent without limits
All reasons and checks
Russian stack

ilyavlasoff/retailcrm-plugin

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add plugins/retailcrm-plugin

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

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

  • Mutations can change orders, customers, deliveries, payments and conversations in the live RetailCRM account
  • The skill requires confirmation before a mutation, but reads are available to the agent without limits

This is third-party code. Review the repository files before installing.

What it does

The plugin combines two parts. First, a remote MCP server retailcrm_mcp at mcp.rcrm-tech.ru that provides tools to search RetailCRM GraphQL API operations, fetch their contracts, resolve types, and execute queries and mutations. Second, a use-retailcrm skill with a step-by-step protocol for the agent: find a suitable operation, fetch only the needed part of the schema, build a minimal GraphQL document, validate it fully, and only then execute it, with a mutation requiring separate explicit user confirmation before running. One repository installs both as an OpenAI Codex marketplace plugin and in Claude Code.

Who it is for. For RetailCRM teams who want to give an agent access to orders, customers and other CRM entities through a safe confirmation protocol.

Good fit when

  • You need agent access to arbitrary RetailCRM entities via GraphQL without hand-writing queries
  • You need mutations to run only after separate user confirmation
  • You need one repository that installs into both OpenAI Codex and Claude Code

Not a fit when

  • You need confirmed vendor official status: the plugin is hosted on the developer's personal GitHub account, not the RetailCRM organization
  • You need a local server with no calls to the external host mcp.rcrm-tech.ru
  • You want to work with the RetailCRM REST API directly rather than through GraphQL

Example request

Find all RetailCRM orders for this customer by email and show their statuses without changing anything

Limitations

The README calls the plugin official for RetailCRM and lists the plugin.json author as RetailCRM Team, but the repository itself belongs to the developer's personal account ilyavlasoff, not a RetailCRM organization on GitHub, so official status cannot be confirmed from GitHub alone. The MCP server is remote and hosted on the third-party host mcp.rcrm-tech.ru; the server's own source code is not published in this repository, only the client side (plugin and skill).

How to disable. Remove the plugin with claude plugin uninstall retailcrm in Claude Code, or by removing the marketplace in OpenAI Codex.

FAQ

Does installing the plugin require an OAuth login?

No, the README states plainly that installing the plugin needs no OAuth login.

Can the agent run a mutation right away?

No, the skill requires separate explicit user confirmation before executing any mutation.

Discussion

No questions or reviews yet.

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 access3Repository stars

RetailCRM MCP

retailcrm-mcp

Russian stack

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

MCP serverBroad access2Repository stars
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

RetailCRM MCP server

RetailCRM MCP Server

Russian stack

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

MCP serverBroad access1Repository stars
Official

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

CLIExtended access1Repository stars
Russian stack

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

MCP serverBroad access38Repository stars

README in short

The Russian README describes the plugin as combining the RetailCRM MCP server and the use-retailcrm skill, giving step-by-step install instructions for OpenAI Codex via a marketplace and for Claude Code via claude plugin marketplace add and claude plugin install. It separately stresses that the skill safely locates operations and schema types before running a request and never lets a mutation through without user confirmation.

README badge

Original SKILL.md

---
name: use-retailcrm
description: Use retailcrm_mcp to work with the official RetailCRM GraphQL API: search and inspect the schema, then build, validate, and execute arbitrary GraphQL queries and mutations. Apply when reading or changing data in a connected RetailCRM account, including orders, customers, deliveries, payments, products, inventory, users, chats, conversations, messages, quick replies, bots, channels, templates, and other CRM entities.
---

# Use RetailCRM

Communicate with the user in the language of their request.

Work with RetailCRM only through retailcrm_mcp. Do not bypass retailcrm_mcp with direct HTTP requests or use guessed API methods.

Do not request, expose, or store access tokens.

If retailcrm_mcp is unavailable or returns 401/403, explain that its connection or authentication must be configured outside this skill, then stop.

Report a problem