mcp-woocommerce

Production-grade MCP server for the WooCommerce REST API — 34 tools for products, orders, customers, coupons, reports, shipping, payments, webhooks, and system management.

Why This Exists

WooCommerce powers 36% of all e-commerce (5M+ active stores) but has zero comprehensive MCP servers. This fills that gap with 34 production-ready tools covering the entire WooCommerce REST API v3.

Features

34 tools across 8 categories (products, orders, customers, coupons, reports, shipping/payments, webhooks, system)
Full CRUD for products, orders, customers, and coupons
Reports & analytics — sales reports, top sellers, order totals, product totals
Webhook management — create, list, delete webhooks for real-time event handling
System diagnostics — WooCommerce/WordPress versions, plugins, server environment
Shipping zones with methods, payment gateways, tax rates
Production-grade error handling with typed exceptions
Simple auth — consumer key + secret via environment variables

Quick Start

Install

pip install mcp-woocommerce

Configure

Set your WooCommerce REST API credentials as environment variables:

export WOOCOMMERCE_URL="https://yourstore.com"
export WOOCOMMERCE_KEY="ck_your_consumer_key"
export WOOCOMMERCE_SECRET="cs_your_consumer_secret"

Generate API keys at: WordPress Admin > WooCommerce > Settings > Advanced > REST API

Run

mcp-woocommerce

Or run as a module:

python -m mcp_woocommerce

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "woocommerce": {
      "command": "mcp-woocommerce",
      "env": {
        "WOOCOMMERCE_URL": "https://yourstore.com",
        "WOOCOMMERCE_KEY": "ck_your_consumer_key",
        "WOOCOMMERCE_SECRET": "cs_your_consumer_secret"
      }
    }
  }
}

Tools (34)

Store

Tool	Description
`ping`	Validate connection and get store info

Products (7)

Tool	Description
`list_products`	List products with filters (status, category, search, on_sale)
`get_product`	Full product details (pricing, inventory, images, attributes)
`create_product`	Create a product (simple, variable, grouped, external)
`update_product`	Update product fields (price, stock, status, etc.)
`delete_product`	Delete or trash a product
`search_products`	Search by name or SKU
`list_product_categories`	List categories with hierarchy

Orders (7)

Tool	Description
`list_orders`	List orders with filters (status, customer, date range)
`get_order`	Full order details (items, billing, shipping, payment)
`create_order`	Create an order with line items
`update_order_status`	Change order status (pending, processing, completed, etc.)
`list_order_notes`	Get all notes on an order
`create_order_note`	Add staff or customer-facing notes
`create_refund`	Issue a refund

Customers (4)

Tool	Description
`list_customers`	List customers with filters (role, search)
`get_customer`	Full customer details with addresses and order stats
`create_customer`	Create a new customer
`search_customers`	Search by name or email

Coupons (4)

Tool	Description
`list_coupons`	List coupons with search
`get_coupon`	Full coupon details (restrictions, limits, usage)
`create_coupon`	Create percent, fixed cart, or fixed product coupons
`delete_coupon`	Delete a coupon

Reports (4)

Tool	Description
`get_sales_report`	Sales totals by period (week, month, year, custom range)
`get_top_sellers`	Top-selling products by period
`get_order_totals`	Order counts by status
`get_product_totals`	Product counts by type

Shipping & Payments (3)

Tool	Description
`list_shipping_zones`	Shipping zones with their methods
`list_payment_gateways`	Payment gateways with enabled status
`list_tax_rates`	All configured tax rates

Webhooks (3)

Tool	Description
`list_webhooks`	List all webhooks
`create_webhook`	Create webhooks for order/product/customer events
`delete_webhook`	Delete a webhook

System (1)

Tool	Description
`get_system_status`	WooCommerce/WordPress versions, plugins, server environment

Authentication

WooCommerce uses consumer key + consumer secret for REST API auth. This server uses HTTP Basic Authentication over HTTPS.

Go to WordPress Admin > WooCommerce > Settings > Advanced > REST API
Click Add key
Set permissions to Read/Write
Copy the consumer key (ck_...) and consumer secret (cs_...)

Important: Your store must use HTTPS for Basic Auth to work securely.

Requirements

Python 3.10+
WooCommerce 3.5+ with REST API v3
HTTPS enabled on your store

License

MIT

WooCommerce MCP Server