# Naver Commerce

> Naver Commerce is an open-source MCP server for e-commerce. Naver Smart Store products, orders, inquiries and stock for assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://appmonster.co.kr
- **Repository:** https://github.com/groove79/kmcp/tree/HEAD/packages/naver-commerce
- **MCP Registry name:** io.github.groove79/mcp-naver-commerce
- **Categories:** e-commerce
- **Listing updated:** 2026-11-15

## About

Sellers on Naver Smart Store spend much of the day checking orders and answering customers. This server wraps the Naver Commerce API so an assistant can list products, read orders changed since a time, read one-to-one customer inquiries and change stock, in Korean or English.

Write tools are marked destructive so clients can ask first, and an optional OK Agent key sends each write to your phone for approval on KakaoTalk. Credentials come only from environment variables, tokens are cached in memory and refreshed shortly before expiry, and the only host contacted is api.commerce.naver.com. Errors return Naver's own code and message so the agent can explain failures.

The README documents some Naver quirks the tools handle: there is no stock-only endpoint so the whole channel product is updated, and Naver ignores the status on create, so the tool follows up with a suspension update before returning the real status. It lists a live check run on 2026-10-21.

## Features

- **Product listing:** Lists products with paging and filters and reads one channel product with options and stock.
- **Order reading:** Returns orders changed since a given time, with details.
- **Inquiry reading:** Lists customer inquiries in a date range.
- **Stock updates:** Changes stock for products with or without options.
- **Product creation:** Creates a product from the Japan bridge draft shape, held in suspended status for review.
- **Approval modes:** Writes can wait for confirmation in chat or approval on KakaoTalk.

## Good for

- Ask whether new orders came in since yesterday
- Set a product's stock to zero
- Find unanswered customer inquiries
- Upload images and create a draft product for review

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-naver-commerce --env NAVER_COMMERCE_CLIENT_ID='<NAVER_COMMERCE_CLIENT_ID>' --env NAVER_COMMERCE_CLIENT_SECRET='<NAVER_COMMERCE_CLIENT_SECRET>' --env OKAGENT_API_KEY='<OKAGENT_API_KEY>' -- npx -y @appmonster/mcp-naver-commerce
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-naver-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-naver-commerce"
      ],
      "env": {
        "NAVER_COMMERCE_CLIENT_ID": "<NAVER_COMMERCE_CLIENT_ID>",
        "NAVER_COMMERCE_CLIENT_SECRET": "<NAVER_COMMERCE_CLIENT_SECRET>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-naver-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-naver-commerce"
      ],
      "env": {
        "NAVER_COMMERCE_CLIENT_ID": "<NAVER_COMMERCE_CLIENT_ID>",
        "NAVER_COMMERCE_CLIENT_SECRET": "<NAVER_COMMERCE_CLIENT_SECRET>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-naver-commerce": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-naver-commerce"
      ],
      "env": {
        "NAVER_COMMERCE_CLIENT_ID": "<NAVER_COMMERCE_CLIENT_ID>",
        "NAVER_COMMERCE_CLIENT_SECRET": "<NAVER_COMMERCE_CLIENT_SECRET>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-naver-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-naver-commerce"
      ],
      "env": {
        "NAVER_COMMERCE_CLIENT_ID": "<NAVER_COMMERCE_CLIENT_ID>",
        "NAVER_COMMERCE_CLIENT_SECRET": "<NAVER_COMMERCE_CLIENT_SECRET>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-naver-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-naver-commerce"
      ],
      "env": {
        "NAVER_COMMERCE_CLIENT_ID": "<NAVER_COMMERCE_CLIENT_ID>",
        "NAVER_COMMERCE_CLIENT_SECRET": "<NAVER_COMMERCE_CLIENT_SECRET>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>"
      }
    }
  }
}
```

## Tools

- `naver_list_products`: Lists products with paging and filters.
- `naver_get_product`: Channel product detail including options and stock.
- `naver_update_stock`: Changes stock for a product or its options; a write action.
- `naver_list_orders`: Orders changed since a time, with details.
- `naver_list_inquiries`: Customer inquiries in a date range.
- `naver_upload_images`: Uploads images by URL or base64 to Naver and returns hosted URLs.
- `naver_create_product`: Creates a product and channel product, held in suspended status for review; a write action.

## FAQ

### What credentials does it need?

A client id and secret from the Naver Commerce API Center after registering an application.

### Which tools can change data?

Stock updates, image upload and product creation are writes; the rest are read-only.

### Where do credentials go?

The README says they come only from environment variables and nothing is sent except to api.commerce.naver.com.

### Is it open source?

Yes, MIT licensed by Appmonster.

### Is Naver Commerce free?

Yes. Naver Commerce is open source, so you can use and self-host it for free.

### How do I add Naver Commerce to Claude Code?

Run this command in your terminal: claude mcp add mcp-naver-commerce --env NAVER_COMMERCE_CLIENT_ID='<NAVER_COMMERCE_CLIENT_ID>' --env NAVER_COMMERCE_CLIENT_SECRET='<NAVER_COMMERCE_CLIENT_SECRET>' --env OKAGENT_API_KEY='<OKAGENT_API_KEY>' -- npx -y @appmonster/mcp-naver-commerce

### What are the best alternatives to Naver Commerce?

The closest alternatives to Naver Commerce are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/naver-commerce
