Skip to content
MCP server

WooCommerce MCP

Manage multiple WooCommerce stores from an AI client, with previewed writes

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.6.0
Listing updated
3 days ago

About WooCommerce MCP

WooCommerce MCP is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

  • WOOCOMMERCE_URLStore origin, such as https://store.example.comRequired
  • WOOCOMMERCE_CONSUMER_KEYWooCommerce REST API consumer key (ck_...)Required
  • WOOCOMMERCE_CONSUMER_SECRETWooCommerce REST API consumer secret (cs_...)Required
  • WOOCOMMERCE_READ_ONLYRefuse every write tool. Set to false to allow writes
  • WOOCOMMERCE_REDACT_PIIMask customer names, emails, phones, and addresses in results
  • WOOCOMMERCE_TOOLS_DENYComma-separated tool names or patterns to hide, such as delete_*

What it does

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

Pricing

Open source

Prices change. Check sadrmanesh.github.io before you buy.

WooCommerce MCP 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 to WooCommerce MCP

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data