Ozon Seller MCP Server — Claude Code MCP server: 26 tools
Wires an AI client into an Ozon seller account: products, prices, orders, analytics, finance. Useful when store admin work keeps eating your day.
claude mcp add ozon-seller -e OZON_CLIENT_ID=<OZON_CLIENT_ID> -e OZON_API_KEY=<OZON_API_KEY> -- npx -y @woyax/mcp-ozon-sellerWhat Ozon Seller MCP Server does
The server exposes 26 tools across seven groups: account, products, prices and stocks, orders, analytics, finance, returns and rating. An agent can pull a product card, rewrite prices in bulk, list FBS orders still waiting to ship, or build a revenue report for a chosen period. Two transports are available. Locally it runs over stdio; over HTTP several people can share one instance, with credentials sent along on every request.
You need a Seller API key first. Create it in the Ozon seller cabinet under Settings → API Integrations → Seller API with the Admin role — some tools stay dark without it. Then drop OZON_CLIENT_ID and OZON_API_KEY into the client config. HTTP mode reads MCP_PORT, which defaults to 3000.
Ozon caps request rates, so the server retries on 429 with growing backoff. get_warehouse_stocks sits under tighter limits than the rest, and looping over it will get you throttled. Licensing is MIT + Commons Clause: free for personal and in-house use, while reselling it as a hosted service needs the author's permission.
What it helps with
- check stock levels across every warehouse
- reprice hundreds of listings in one go
- pull FBS orders awaiting shipment
- build a revenue and returns report for a period
- look up the seller quality index
Example prompts for the agent
- Show revenue and order count for the past week
- List every product that is out of stock
- Set the price of the item with
offer_idABC-123 to 1990 rubles
How to install Ozon Seller MCP Server
Platform CLI
claude mcp add ozon-seller -e OZON_CLIENT_ID=<OZON_CLIENT_ID> -e OZON_API_KEY=<OZON_API_KEY> -- npx -y @woyax/mcp-ozon-sellerReplace <…> with your own values
Platform CLI
codex mcp add ozon-seller-mcp-server --env OZON_CLIENT_ID=<OZON_CLIENT_ID> --env OZON_API_KEY=<OZON_API_KEY> -- npx -y @woyax/mcp-ozon-sellerReplace <…> with your own values
Config file
{
"mcpServers": {
"ozon-seller-mcp-server": {
"command": "npx",
"args": [
"-y",
"@woyax/mcp-ozon-seller"
],
"env": {
"OZON_CLIENT_ID": "<OZON_CLIENT_ID>",
"OZON_API_KEY": "<OZON_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"ozon-seller-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@woyax/mcp-ozon-seller"
],
"env": {
"OZON_CLIENT_ID": "<OZON_CLIENT_ID>",
"OZON_API_KEY": "<OZON_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OZON_CLIENT_ID=<OZON_CLIENT_ID> -e OZON_API_KEY=<OZON_API_KEY> ozon-seller-mcp-server npx -y @woyax/mcp-ozon-sellerReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Ozon Seller MCP Server
How do I install Ozon Seller MCP Server in Claude Code?
Run claude mcp add ozon-seller -e OZON_CLIENT_ID=<OZON_CLIENT_ID> -e OZON_API_KEY=<OZON_API_KEY> -- npx -y @woyax/mcp-ozon-seller, replacing the placeholders with your own values.
What does Ozon Seller MCP Server do?
It gives an agent access to the Ozon Seller API: product cards, prices and stock, FBO and FBS orders, sales analytics, finance reports, returns and seller rating — 26 tools in total.
What credentials does the server need?
A numeric OZON_CLIENT_ID and an OZON_API_KEY from the Ozon seller cabinet. The key must be created with the Admin role, or some tools will not work.
