Cafe24

io.github.groove79Published by GitHub account groove79v0.2.0Updated Oct 29, 2026

Cafe24 mall MCP: products, variant stock, orders, board posts. 카페24 쇼핑몰 MCP 서버.

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

MCP server for the Cafe24 Admin API that lets an assistant list and edit products, set variant stock, read orders and post board articles in a Cafe24 mall.

What you can do
  • List products with paging and filters, and read one product's variants, prices and stock
  • Change a product's name, price, display or selling status, and set a variant's stock quantity
  • List orders in a date range with items, buyer and receivers, optionally filtered by status
  • List the mall's boards and publish an article to a board, with HTML allowed in the content
When to use it
Useful when you run a Cafe24 store and want an assistant to answer questions about products and recent orders, adjust prices or stock, or publish notices and board posts without opening the admin each time.
Requirements
Runs locally over stdio via npx (Node.js). Needs a Cafe24 Developers app with a Client ID, Client Secret and your mall id, plus a one-time browser authorization that stores a token on disk; the redirect URI must be https on a domain you control. Optional variables seed a refresh token, set the API version, shop number or redirect URI, and an OK Agent key enables KakaoTalk approval.
Before you install
Requires the app's Client Secret and a refresh token, which are stored in a local config file and rotate every two weeks. Product, inventory and article writes are irreversible and go straight to the live store; write mode defaults to approval or chat confirmation, but direct mode applies changes immediately. Order data includes buyer and receiver details, and the optional OK Agent key sends write approvals through a third-party service.

Installation

In SourceWeft

  1. Open Cafe24 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@appmonster/mcp-cafe24

MCP server for the Cafe24 Admin API. Lets Claude, Cursor or ChatGPT manage a Cafe24 mall: list and edit products, set variant stock, read orders, post board articles — with human approval on writes.

카페24 쇼핑몰 MCP 서버. 에이전트가 상품·재고·주문·게시판을 직접 다룹니다.

Setup (one time)

  1. Create an app at Cafe24 Developers (log in with your Cafe24 mall account → 파트너 가입 → App 관리 → ADD PRODUCT → Web).
    • Redirect URI must be https:// on a domain you control — Cafe24 rejects http:// and IPs. Any page works, even one that 404s: the code arrives in the address bar (e.g. https://yourdomain.com/cafe24/callback).
    • 권한선택 (쇼핑몰 운영자): 상품·주문·게시판 → 읽기+쓰기, 상점 → 읽기. 타임존 Asia/Seoul. 저장.
    • Note the Client ID and Client Secret Key (인증정보 → 보기); your mall id is the subdomain of your admin ({mall_id}.cafe24.com).
  2. Authorize once (stores a token in ~/.config/kmcp/cafe24/<mall_id>.json):
    bash
    CAFE24_MALL_ID=yourmall CAFE24_CLIENT_ID=... CAFE24_CLIENT_SECRET=... \CAFE24_REDIRECT_URI=https://yourdomain.com/cafe24/callback npx -y @appmonster/mcp-cafe24 auth
    It opens the mall admin; click 동의함; the browser lands on your redirect URL with ?code=…. Paste that URL back into the terminal within 1 minute. (With an http://localhost redirect the CLI catches it automatically — local dev only.) Access tokens last 2 h and refresh themselves; the refresh token rotates and lasts 2 weeks, so if the server goes unused longer than that, run auth again.

Verified live against a real mall (2026-10): products, variants, inventory write, orders, boards, token refresh rotation. Writes are applied immediately but a read within ~1–2 s may still show the old value.

Install

Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "cafe24": {      "command": "npx",      "args": ["-y", "@appmonster/mcp-cafe24"],      "env": {        "CAFE24_MALL_ID": "yourmall",        "CAFE24_CLIENT_ID": "your-client-id",        "CAFE24_CLIENT_SECRET": "your-client-secret"      }    }  }}

Optional env: CAFE24_REFRESH_TOKEN (seed a token without the browser step), CAFE24_API_VERSION (default 2026-09-01; if Cafe24 retires it the client switches to the version Cafe24 names in its error and continues), CAFE24_SHOP_NO (default 1), CAFE24_REDIRECT_URI.

Tools

ToolAccessWhat it does
cafe24_list_productsreadGET /admin/products with name/display/selling filters
cafe24_get_productreadProduct detail + variants (option codes, stock)
cafe24_update_productwriteName, price, display, selling — only fields you pass
cafe24_update_inventorywriteSet a variant's stock (PUT …/variants/{code}/inventories)
cafe24_list_ordersreadOrders in a date range with items, buyer, receivers
cafe24_list_boardsreadBoards and their numbers
cafe24_create_articlewritePost to a board (notice, blog, Q&A answer)

Write tools carry destructiveHint: true and honour an approveWrite hook.

Example prompts

  • "이번 주 신규 주문 몇 건이야? 미발송 건만 보여줘"
  • "'전동 드릴' 상품 가격을 89,000원으로 바꿔줘"
  • "공지사항 게시판에 추석 배송 안내 올려줘"

MIT © Appmonster

Source: packages/cafe24/README.md at commit 53af4ba

Tools

7

cafe24_list_products

List products in the Cafe24 mall with paging and filters (name, display/selling status, product numbers). 카페24 상품 목록을 조회합니다. Use first to find product_no before reading or changing a product. Needs nothing.

Parameterslimitoffsetdisplaysellingproduct_noproduct_name

cafe24_get_product

Get one product with its variants (options), prices, stock and status by product_no. 상품 상세(옵션·재고 포함)를 조회합니다. Use before cafe24_update_inventory to get variant_code. Needs product_no.

Parametersproduct_norequired

cafe24_update_product

Change a product's name, price, display or selling status. Only the fields you pass are changed. 상품의 이름·가격·진열·판매 상태를 수정합니다. IRREVERSIBLE: changes the live store. Needs product_no + at least one field.

Parameterspricedisplaysellingproduct_norequiredproduct_nameconfirm_token

cafe24_update_inventory

Set the stock quantity of one variant (option) of a product. 옵션(품목) 재고 수량을 변경합니다. IRREVERSIBLE. Needs product_no + variant_code (from cafe24_get_product → variants[].variant_code) + quantity.

Parametersquantityrequiredproduct_norequiredvariant_coderequiredconfirm_token

cafe24_list_orders

List orders in a date range (default: last 7 days) with items and buyer, optionally filtered by status. 주문 목록을 조회합니다(품목·구매자 포함). Use for 'any new orders?'. Needs nothing; max 3-month range per call.

Parameterslimitoffsetend_datestart_dateorder_status

cafe24_list_boards

List the mall's boards (notice, Q&A, review, free) with their board_no. 게시판 목록을 조회합니다. Use before posting. Needs nothing.

Takes no parameters.

cafe24_create_article

Post an article to a board (e.g. a notice or blog-style post). HTML allowed in content. 게시판에 글을 등록합니다. IRREVERSIBLE: publishes to the live site. Needs board_no (from cafe24_list_boards), title, content.

Parameterstitlerequiredwritercontentrequireddisplayboard_norequiredconfirm_token

Version history

2
  1. v0.2.0LatestOct 23, 2026
  2. v0.1.1Oct 21, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts