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
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
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/retailcrm-pluginDetects 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.
- 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 anythingLimitations
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.
Related
All RetailCRM toolsRetailCRM plugin for Claude Code and Codex: a remote MCP server with GraphQL access to the CRM and a skill with safe-use rules
RetailCRM MCP
retailcrm-mcp
RetailCRM MCP server: orders, customers, products, stock, payments, tasks and store analytics via API v5
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 MCP server
RetailCRM MCP Server
A RetailCRM MCP server with one-click Railway or Render deploy: orders, customers, products, statistics 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
A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data
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.