Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
WooCommerce MCP
概要
作者による説明(英語の原文)
Manage WooCommerce stores: products, orders, customers, coupons, webhooks, and analytics.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況i未計測★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンで動く
- トランスポート: stdio
- カテゴリ: ネットショップ・決済
- 入力が必要なもの:WOOCOMMERCE_URL, WOOCOMMERCE_CONSUMER_KEY, WOOCOMMERCE_CONSUMER_SECRET
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:1項目中1項目に合格
- あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
- 自分で入力するもの:
WOOCOMMERCE_URL,WOOCOMMERCE_CONSUMER_KEY,WOOCOMMERCE_CONSUMER_SECRET,WOOCOMMERCE_READ_ONLY,WOOCOMMERCE_REDACT_PII,WOOCOMMERCE_TOOLS_DENY
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
- npmNode.jsのインストール(npxコマンドに必要)
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"woocommerce": {
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "your-value",
"WOOCOMMERCE_CONSUMER_KEY": "your-value",
"WOOCOMMERCE_CONSUMER_SECRET": "your-value",
"WOOCOMMERCE_READ_ONLY": "your-value",
"WOOCOMMERCE_REDACT_PII": "your-value",
"WOOCOMMERCE_TOOLS_DENY": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add woocommerce --env WOOCOMMERCE_URL=your-value --env WOOCOMMERCE_CONSUMER_KEY=your-value --env WOOCOMMERCE_CONSUMER_SECRET=your-value --env WOOCOMMERCE_READ_ONLY=your-value --env WOOCOMMERCE_REDACT_PII=your-value --env WOOCOMMERCE_TOOLS_DENY=your-value -- npx -y @sadrmanesh/woocommerce-mcp動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"woocommerce": {
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "your-value",
"WOOCOMMERCE_CONSUMER_KEY": "your-value",
"WOOCOMMERCE_CONSUMER_SECRET": "your-value",
"WOOCOMMERCE_READ_ONLY": "your-value",
"WOOCOMMERCE_REDACT_PII": "your-value",
"WOOCOMMERCE_TOOLS_DENY": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"woocommerce": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "your-value",
"WOOCOMMERCE_CONSUMER_KEY": "your-value",
"WOOCOMMERCE_CONSUMER_SECRET": "your-value",
"WOOCOMMERCE_READ_ONLY": "your-value",
"WOOCOMMERCE_REDACT_PII": "your-value",
"WOOCOMMERCE_TOOLS_DENY": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
- Store origin, such as https://store.example.com
- WooCommerce REST API consumer key (ck_...)
- WooCommerce REST API consumer secret (cs_...)
WOOCOMMERCE_READ_ONLYenvRefuse every write tool. Set to false to allow writesWOOCOMMERCE_REDACT_PIIenvMask customer names, emails, phones, and addresses in resultsWOOCOMMERCE_TOOLS_DENYenvComma-separated tool names or patterns to hide, such as delete_*
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント sadrmanesh で確認済みです
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
ネットショップ・決済のほかのサーバーとの比較i
- このカテゴリのほかの2538件のうち0%よりスターが多い
- このカテゴリのほかの2538件のうち80%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの2538件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
WooCommerce MCPは安全ですか?
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:WOOCOMMERCE_URL, WOOCOMMERCE_CONSUMER_KEY, WOOCOMMERCE_CONSUMER_SECRET
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(0.6.0)がレジストリに届いたのは7 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
woocommerce-mcp
A Model Context Protocol server for running one or more WooCommerce stores through the WooCommerce REST API. MCP clients can browse the catalog, work through and fulfill orders, issue refunds, adjust prices and stock in bulk, run promotions, segment customers, react to webhooks, and read sales analytics. Every change is previewed before it is applied and can be written to an audit log.
It runs locally over stdio, or as a remote service over streamable HTTP with bearer-token or OAuth 2.0 authentication, and ships as a Docker image on the GitHub Container Registry.
Documentation: https://sadrmanesh.github.io/woocommerce-mcp/ · Tool explorer: Hugging Face Space
Read more: Safe write tools for agents: preview, confirm, audit, and stale previews in a WooCommerce MCP server on Dev.to · Preview, confirm, audit on LinkedIn · Update: A week of reader feedback: what changed in my four AI-for-commerce tools on Dev.to · What reader feedback taught me about building production-safe AI tooling for commerce on LinkedIn
Listed on the official MCP Registry as io.github.sadrmanesh/woocommerce-mcp, on Glama, and on mcpservers.org.
Contents
- Highlights
- Quick start
- Connect an MCP client
- Tools, resources, and prompts
- Safe writes
- Configuration
- Deployment
- Development
- Documentation
Highlights
- Multi-store. Configure any number of stores and pick one per call with
store. Each store has its own credentials and its own read-only switch. - Safe by default. Stores are read-only until you allow writes. Write tools then return a preview of the exact REST request and apply it only when called again with
confirm: true. A confirm is refused if the arguments or the store data the change was computed from changed since the preview.dryRun: truealways previews. - Signed approvals (optional). Set
WOOCOMMERCE_APPROVAL_SECRETand a confirm also needs a short-lived, single-use token signed for that exact preview by someone outside the agent's reach, for example withwoocommerce-mcp approve. The agent cannot approve its own writes. - Audit log. One JSON line per write attempt: applied, previewed, refused, or failed, with the tool, store, arguments, caller, and a preview id that links each confirmed write to its preview.
- Refunds and bulk operations. Partial or line-item refunds, batch updates of up to 100 products, and percentage or fixed price adjustments.
- Analytics. Sales by day, week, or month with refunds, average order value, top products, and payment methods, plus a low-stock report that covers variations.
- Promotions and customers. Coupon performance, scheduled sales, and customer segments such as VIP, repeat, and at risk.
- Fulfillment. Order notes, shipment tracking, and one-step fulfillment that emails the customer.
- Webhooks. Manage store webhooks and receive signed deliveries, readable as MCP resources.
- Shipping and taxes. Read shipping zones, methods, tax rates, and tax classes.
- Privacy and control. Optional PII redaction, and tool allow and deny lists per deployment or per store.
- Gentle on the store. Per-store rate limiting, retries with backoff and jitter, and an optional read cache.
- Remote ready. Streamable HTTP with static bearer tokens (full or read-only) or RFC 7662 token introspection, RFC 9728 protected resource metadata, Host and Origin checks, and a health endpoint.
- MCP resources and prompts. Read products and orders by URI, and start common workflows such as a sales briefing or a restock plan.
- Observability. Optional OpenTelemetry traces for every tool call and WooCommerce request.
- Well tested. Strict TypeScript, Zod validation on every input, and tests against a mocked WooCommerce API.
Quick start
Node.js 20 or newer is required.
npm install -g @sadrmanesh/woocommerce-mcp
Or run the Docker image from the GitHub Container Registry (linux/amd64 and linux/arm64, tags X.Y.Z, X.Y, and latest). The same image is on Docker Hub as sadrmanesh/woocommerce-mcp:
docker run --rm -i -e MCP_TRANSPORT=stdio \
-e WOOCOMMERCE_URL -e WOOCOMMERCE_CONSUMER_KEY -e WOOCOMMERCE_CONSUMER_SECRET \ ghcr.io/sadrmanesh/woocommerce-mcp:0.6.0
The npm package is also on GitHub Packages; see Install options for the .npmrc setup. npmjs.com remains the main registry.
Or from a checkout:
git clone https://github.com/sadrmanesh/woocommerce-mcp.git
cd woocommerce-mcp npm install npm run build cp .env.example .env
Create a REST API key under WooCommerce > Settings > Advanced > REST API. Use a Read key while the store is read-only, and a Read/Write key only when you enable writes. WordPress permalinks must not be set to "Plain", or /wp-json/ will not resolve.
WOOCOMMERCE_URL=https://store.example.com \
WOOCOMMERCE_CONSUMER_KEY=ck_... \ WOOCOMMERCE_CONSUMER_SECRET=cs_... \ woocommerce-mcp
The process then serves MCP on stdin and stdout. Logs go to stderr. npm start in a checkout loads .env from the working directory without overriding variables that are already set.
Connect an MCP client
Most hosts accept an mcpServers map like the ones below. Keep secrets in env, never in args. Docker, Smithery, and MCP Registry installs are in docs/install.md.
stdio
{
"mcpServers": { "woocommerce": { "command": "npx", "args": ["-y", "@sadrmanesh/woocommerce-mcp"], "env": { "WOOCOMMERCE_URL": "https://store.example.com", "WOOCOMMERCE_CONSUMER_KEY": "ck_your_consumer_key", "WOOCOMMERCE_CONSUMER_SECRET": "cs_your_consumer_secret" } } } }
From a checkout, use "command": "node" and "args": ["/absolute/path/to/woocommerce-mcp/dist/index.js"].
Streamable HTTP
MCP_TRANSPORT=http MCP_HTTP_AUTH_TOKENS="$(openssl rand -base64 32)" woocommerce-mcp
{
"mcpServers": { "woocommerce": { "type": "http", "url": "https://mcp.example.com/mcp", "headers": { "Authorization": "Bearer " } } } }
Without authentication the HTTP endpoint only binds to loopback. See docs/security.md for tokens, scopes, and OAuth introspection.
Tools, resources, and prompts
Every tool except woocommerce_list_stores accepts an optional store id. Without it, the default store is used.
To browse every tool with its full input schema and build tools/call requests in the browser, open the tool explorer on Hugging Face.
| Area | Read tools | Write tools |
|---|---|---|
| Stores | list_stores | |
| Products | list_products, search_products, get_product | create_product, update_product, bulk_update_products, bulk_adjust_prices |
| Orders | list_orders, get_order, list_order_notes | update_order_status, add_order_note, delete_order_note |
| Fulfillment | get_order_tracking | fulfill_order |
| Refunds | list_refunds, get_refund | create_refund |
| Customers | list_customers, get_customer, customer_orders, customer_segments | update_customer |
| Stock | get_stock, low_stock_report | update_stock |
| Coupons and sales | list_coupons, get_coupon, coupon_performance | create_coupon, update_coupon, delete_coupon, schedule_sale, end_sale |
| Webhooks | list_webhooks, get_webhook, list_webhook_events | create_webhook, update_webhook, delete_webhook |
| Shipping and taxes | list_shipping_zones, list_shipping_methods, list_tax_rates, list_tax_classes | |
| Analytics | get_store_summary, sales_analytics |
Every name starts with woocommerce_, for example woocommerce_customer_segments. That makes 47 tools: 28 reads and 19 writes.
Resources
| URI | Content |
|---|---|
woocommerce://stores | Configured stores |
woocommerce://stores/{store}/products/{id} | One product |
woocommerce://stores/{store}/orders/{id} | One order |
woocommerce://stores/{store}/events | Recent webhook deliveries |
woocommerce://stores/{store}/events/{id} | One webhook delivery with its payload |
Prompts: sales_briefing, restock_plan, order_triage, and price_change_review.
Full argument and response details are in docs/tools.md.
Safe writes
- Read-only stores. A store accepts writes only when
WOOCOMMERCE_READ_ONLY=false(single store) or"readOnly": false(store list). Otherwise write tools fail withread_onlybefore contacting the store. - Confirmation. With
WOOCOMMERCE_REQUIRE_CONFIRMATION=true(the default), the first call returns the planned request and changes nothing:
{
"status": "confirmation_required", "store": "default", "previewId": "pv_4f1c9a2e7b3d0856", "message": "The change was NOT applied. ...", "request": { "method": "PUT", "path": "orders/1015",
冒頭だけを表示しています。続きはリポジトリで読めます