# WooCommerce MCP

> WooCommerce MCP is an open-source MCP server for e-commerce. Manage multiple WooCommerce stores from an AI client, with previewed writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://sadrmanesh.github.io/woocommerce-mcp/
- **Repository:** https://github.com/sadrmanesh/woocommerce-mcp
- **MCP Registry name:** io.github.sadrmanesh/woocommerce-mcp
- **Categories:** e-commerce
- **Listing updated:** 2026-11-14

## About

Stores are read-only until you switch writing on. Even then, a write tool first returns the exact REST request it would send, and only applies it when called again with `confirm: true`. If the arguments or the store data changed since the preview, the confirm is refused. An optional approval secret goes further: a confirm then needs a short-lived, single-use token signed outside the agent's reach, so the agent cannot approve its own changes.

The server covers 47 tools across products, orders, fulfillment, customers, coupons, webhooks, shipping, taxes and analytics. It can issue partial or line-item refunds, batch-update up to 100 products, adjust prices by percentage or fixed amount, report sales by day, week or month, and flag low stock including variations. Each store has its own credentials and read-only switch, and every write attempt lands in a JSON-lines audit log.

It runs locally over stdio through npm, or as a remote service over streamable HTTP with bearer tokens or OAuth 2.0 token introspection, and ships a Docker image. Settings include optional masking of customer names, emails and phones, allow and deny lists for tools, per-store rate limiting, and OpenTelemetry traces.

## Features

- **Preview before write:** Write tools return the exact REST request first and apply it only on a second call with confirm.
- **Multi-store support:** Configure any number of stores, each with its own credentials and read-only switch.
- **Refunds and bulk edits:** Partial or line-item refunds, batch updates of up to 100 products, and price adjustments.
- **Sales analytics:** Sales by day, week or month, top products, payment methods and a low-stock report.
- **Audit log:** One JSON line per write attempt, linking each confirmed write to its preview.
- **PII redaction and tool filters:** Mask customer details and hide tools with deny patterns such as delete_*.
- **Local or remote:** Run over stdio with npx, or serve over streamable HTTP with bearer or OAuth auth.

## Good for

- Check which products are low on stock, including variations
- Refund part of an order after reviewing the preview
- Raise prices across a product range by a percentage
- Run a weekly sales briefing across several stores
- Mark an order shipped with tracking and email the customer

## Install

### Claude Code (Terminal)

```sh
claude mcp add woocommerce-mcp --env WOOCOMMERCE_URL='<WOOCOMMERCE_URL>' --env WOOCOMMERCE_CONSUMER_KEY='<WOOCOMMERCE_CONSUMER_KEY>' --env WOOCOMMERCE_CONSUMER_SECRET='<WOOCOMMERCE_CONSUMER_SECRET>' -- npx -y @sadrmanesh/woocommerce-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "woocommerce-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sadrmanesh/woocommerce-mcp"
      ],
      "env": {
        "WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
        "WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
        "WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "woocommerce-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sadrmanesh/woocommerce-mcp"
      ],
      "env": {
        "WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
        "WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
        "WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "woocommerce-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sadrmanesh/woocommerce-mcp"
      ],
      "env": {
        "WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
        "WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
        "WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "woocommerce-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sadrmanesh/woocommerce-mcp"
      ],
      "env": {
        "WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
        "WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
        "WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "woocommerce-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sadrmanesh/woocommerce-mcp"
      ],
      "env": {
        "WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
        "WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
        "WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
      }
    }
  }
}
```

## FAQ

### Can the server change my store without asking?

No. Stores start read-only, and when writing is allowed each change is previewed and needs a confirming second call.

### What credentials does it need?

A store URL plus a WooCommerce REST API consumer key and secret.

### Can I hide customer personal data from the AI?

Yes. An optional setting masks customer names, emails, phones and addresses in results.

### How can I stop it from using destructive tools?

Set a deny list of tool names or patterns, for example delete_*, per deployment or per store.

### Is WooCommerce MCP free?

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

### How do I add WooCommerce MCP to Claude Code?

Run this command in your terminal: claude mcp add woocommerce-mcp --env WOOCOMMERCE_URL='<WOOCOMMERCE_URL>' --env WOOCOMMERCE_CONSUMER_KEY='<WOOCOMMERCE_CONSUMER_KEY>' --env WOOCOMMERCE_CONSUMER_SECRET='<WOOCOMMERCE_CONSUMER_SECRET>' -- npx -y @sadrmanesh/woocommerce-mcp

### What are the best alternatives to WooCommerce MCP?

The closest alternatives to WooCommerce MCP 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/woocommerce-mcp
