ozon-mcp-server — Claude Code MCP server
Connects Ozon Seller API and Performance API to an AI assistant through 156 tools. Use it to manage stores, ads, orders, reviews, and reports from chat.
claude mcp add --env OZON_CLIENT_ID=<OZON_CLIENT_ID> --env OZON_API_KEY=<OZON_API_KEY> --env OZON_PERF_CLIENT_ID=<OZON_PERF_CLIENT_ID> --env OZON_PERF_CLIENT_SECRET=<OZON_PERF_CLIENT_SECRET> --env DATA_DIR=<DATA_DIR> --transport stdio ozon-mcp-server -- uvx ozon-mcp-serverWhat ozon-mcp-server does
ozon-mcp-server exposes Ozon operations to an AI assistant: listings, pricing, promotions, advertising, FBS and FBO orders, returns, reviews, finance, and analytics. Calls use a shop_id, which supports workflows across multiple stores. The server also includes API availability checks and endpoint failure detection.
It can run with uvx ozon-mcp-server and connect over stdio. A Docker setup adds a web dashboard for call counters, errors, diagnostics, and store management. Ozon credentials can be passed as environment variables or entered through /shops; persistent files go into DATA_DIR.
Seller API credentials are required, while Performance API features use OZON_PERF_CLIENT_ID and OZON_PERF_CLIENT_SECRET. Ozon requests will fail until the required API keys are configured.
What it helps with
- inspect store products, prices, and stock
- find items eligible for Ozon promotions
- manage ad campaigns, bids, and budgets
- review orders, returns, and buyer feedback
- pull finance and search analytics
Example prompts for the agent
- Show products for
shop_idstore-1that Ozon wants to include in a promotion. - Compare this store’s ad spend for the week and stop campaigns with poor results.
- Find new five-star reviews and draft replies to those buyers.
How to install ozon-mcp-server
Platform CLI
claude mcp add --env OZON_CLIENT_ID=<OZON_CLIENT_ID> --env OZON_API_KEY=<OZON_API_KEY> --env OZON_PERF_CLIENT_ID=<OZON_PERF_CLIENT_ID> --env OZON_PERF_CLIENT_SECRET=<OZON_PERF_CLIENT_SECRET> --env DATA_DIR=<DATA_DIR> --transport stdio ozon-mcp-server -- uvx ozon-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ozon-mcp-server <command>
Platform CLI
codex mcp add ozon-mcp-server --env OZON_CLIENT_ID=<OZON_CLIENT_ID> --env OZON_API_KEY=<OZON_API_KEY> --env OZON_PERF_CLIENT_ID=<OZON_PERF_CLIENT_ID> --env OZON_PERF_CLIENT_SECRET=<OZON_PERF_CLIENT_SECRET> --env DATA_DIR=<DATA_DIR> -- uvx ozon-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ozon-mcp-server <command>
Config file
{
"mcpServers": {
"ozon-mcp-server": {
"command": "uvx",
"args": [
"ozon-mcp-server"
],
"env": {
"OZON_CLIENT_ID": "<OZON_CLIENT_ID>",
"OZON_API_KEY": "<OZON_API_KEY>",
"OZON_PERF_CLIENT_ID": "<OZON_PERF_CLIENT_ID>",
"OZON_PERF_CLIENT_SECRET": "<OZON_PERF_CLIENT_SECRET>",
"DATA_DIR": "<DATA_DIR>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ozon-mcp-server <command>
Config file
{
"servers": {
"ozon-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"ozon-mcp-server"
],
"env": {
"OZON_CLIENT_ID": "<OZON_CLIENT_ID>",
"OZON_API_KEY": "<OZON_API_KEY>",
"OZON_PERF_CLIENT_ID": "<OZON_PERF_CLIENT_ID>",
"OZON_PERF_CLIENT_SECRET": "<OZON_PERF_CLIENT_SECRET>",
"DATA_DIR": "<DATA_DIR>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ozon-mcp-server <command>
Platform CLI
gemini mcp add -e OZON_CLIENT_ID=<OZON_CLIENT_ID> -e OZON_API_KEY=<OZON_API_KEY> -e OZON_PERF_CLIENT_ID=<OZON_PERF_CLIENT_ID> -e OZON_PERF_CLIENT_SECRET=<OZON_PERF_CLIENT_SECRET> -e DATA_DIR=<DATA_DIR> ozon-mcp-server uvx ozon-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ozon-mcp-server <command>
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-mcp-server
How do I install ozon-mcp-server in Claude Code?
Run claude mcp add ozon-mcp-server -e OZON_API_KEY=<OZON_API_KEY> -e OZON_PERF_CLIENT_SECRET=<OZON_PERF_CLIENT_SECRET> -- uvx ozon-mcp-server.
What does ozon-mcp-server do?
It connects Claude Code to Ozon’s Seller API and Performance API through MCP tools for store operations, advertising, orders, products, reviews, and finance.
Can I connect more than one Ozon store?
Yes. Each request takes a shop_id, and connected-store data is kept under DATA_DIR.
