WooCommerce MCP

Name: WooCommerce MCP
Author: sadrmanesh

by sadrmaneshversion 0.6.0i★ –iRuns on your computer

Registry nameio.github.sadrmanesh/woocommerce-mcp

Install

Overview

Description from the maker (original English)

Manage WooCommerce stores: products, orders, customers, coupons, webhooks, and analytics.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiEarly↓ 829/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Online shops & payments
You need to fill in: WOOCOMMERCE_URL, WOOCOMMERCE_CONSUMER_KEY, WOOCOMMERCE_CONSUMER_SECRET

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: WOOCOMMERCE_URL, WOOCOMMERCE_CONSUMER_KEY, WOOCOMMERCE_CONSUMER_SECRET, WOOCOMMERCE_READ_ONLY, WOOCOMMERCE_REDACT_PII, WOOCOMMERCE_TOOLS_DENY

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into 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"
      }
    }
  }
}

Run this in your terminal

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

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.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"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "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"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

WOOCOMMERCE_URL required env
Store origin, such as https://store.example.com
WOOCOMMERCE_CONSUMER_KEY secret required env
WooCommerce REST API consumer key (ck_...)
WOOCOMMERCE_CONSUMER_SECRET secret required env
WooCommerce REST API consumer secret (cs_...)
WOOCOMMERCE_READ_ONLY env
Refuse every write tool. Set to false to allow writes
WOOCOMMERCE_REDACT_PII env
Mask customer names, emails, phones, and addresses in results
WOOCOMMERCE_TOOLS_DENY env
Comma-separated tool names or patterns to hide, such as delete_*

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sadrmanesh, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Online shops & paymentsi

More stars than 0% of the other 2548 servers in this category
Published to the registry more recently than 79% of the other 2548 servers in this category
Basic checks equal to or better than 100% of the other 2548 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is WooCommerce MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: WOOCOMMERCE_URL, WOOCOMMERCE_CONSUMER_KEY, WOOCOMMERCE_CONSUMER_SECRET

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.6.0) reached the registry 7 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spree Commerce: open-source B2B and marketplace ecommerce

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

by spreeWidely used★ 15.8KUpdated 8 days ago

Runs in the cloud

Install

Stripe MCP

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

by stripeGrowing★ 2KUpdated 12 months ago

Runs in the cloud✓ stripe.com

Install

MCP Cn Commerce

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

by TonyWang-hubEarly↓ 73/wk★ 96Updated 29 days ago

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

Listed on the official MCP Registry as io.github.sadrmanesh/woocommerce-mcp, on Glama, and on mcpservers.org.

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: true always previews.
Signed approvals (optional). Set WOOCOMMERCE_APPROVAL_SECRET and a confirm also needs a short-lived, single-use token signed for that exact preview by someone outside the agent's reach, for example with woocommerce-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 with read_only before 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",

Only the beginning is shown; read the rest in the repo

WooCommerce MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Online shops & paymentsi

Common questions

Alternatives

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

README from the maker

woocommerce-mcp

Contents

Highlights

Quick start

Connect an MCP client

stdio

Streamable HTTP

Tools, resources, and prompts

Safe writes