@cmsmcp/woocommerce

MCP server for WooCommerce -- 95 tools for complete store management including products, orders, customers, coupons, taxes, shipping, webhooks, and more.

Quick Start

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "woocommerce": {
      "command": "npx",
      "args": ["-y", "@cmsmcp/woocommerce"],
      "env": {
        "WOOCOMMERCE_URL": "https://mystore.com",
        "WOOCOMMERCE_CONSUMER_KEY": "ck_xxx",
        "WOOCOMMERCE_CONSUMER_SECRET": "cs_xxx"
      }
    }
  }
}

Claude Code

claude mcp add woocommerce -e WOOCOMMERCE_URL=https://mystore.com -e WOOCOMMERCE_CONSUMER_KEY=ck_xxx -e WOOCOMMERCE_CONSUMER_SECRET=cs_xxx -- npx -y @cmsmcp/woocommerce

Cursor / Windsurf / Any MCP Client

Same JSON config format -- add to your client's MCP settings file.

Configuration

| Variable | Required | Description | |----------|----------|-------------| | WOOCOMMERCE_URL | Yes | Your WordPress/WooCommerce store URL | | WOOCOMMERCE_CONSUMER_KEY | Yes | WooCommerce REST API consumer key (ck_...) | | WOOCOMMERCE_CONSUMER_SECRET | Yes | WooCommerce REST API consumer secret (cs_...) |

Available Tools (95 tools)

Products (10 tools)

| Tool | Description | |------|-------------| | woo_list_products | List products with filtering and pagination | | woo_get_product | Get a single product by ID | | woo_create_product | Create a new product | | woo_update_product | Update an existing product | | woo_delete_product | Delete a product | | woo_list_product_variations | List variations of a variable product | | woo_get_product_variation | Get a single product variation | | woo_create_product_variation | Create a product variation | | woo_update_product_variation | Update a product variation | | woo_delete_product_variation | Delete a product variation |

Product Attributes (10 tools)

| Tool | Description | |------|-------------| | woo_list_product_attributes | List all product attributes | | woo_get_product_attribute | Get a single product attribute | | woo_create_product_attribute | Create a new attribute (e.g., Color, Size) | | woo_update_product_attribute | Update a product attribute | | woo_delete_product_attribute | Delete a product attribute | | woo_list_attribute_terms | List terms for an attribute (e.g., Red, Blue) | | woo_get_attribute_term | Get a single attribute term | | woo_create_attribute_term | Create a new attribute term | | woo_update_attribute_term | Update an attribute term | | woo_delete_attribute_term | Delete an attribute term |

Orders (5 tools)

| Tool | Description | |------|-------------| | woo_list_orders | List orders with filtering and pagination | | woo_get_order | Get a single order by ID | | woo_create_order | Create a new order | | woo_update_order | Update an existing order | | woo_delete_order | Delete an order |

Order Notes (4 tools)

| Tool | Description | |------|-------------| | woo_list_order_notes | List notes for an order | | woo_get_order_note | Get a single order note | | woo_create_order_note | Add a note to an order | | woo_delete_order_note | Delete an order note |

Order Refunds (4 tools)

| Tool | Description | |------|-------------| | woo_list_order_refunds | List refunds for an order | | woo_get_order_refund | Get a single order refund | | woo_create_order_refund | Create a refund for an order | | woo_delete_order_refund | Delete an order refund |

Customers (6 tools)

| Tool | Description | |------|-------------| | woo_list_customers | List customers with filtering | | woo_get_customer | Get a single customer by ID | | woo_create_customer | Create a new customer | | woo_update_customer | Update a customer | | woo_delete_customer | Delete a customer | | woo_get_customer_downloads | Get downloads for a customer |

Coupons (5 tools)

| Tool | Description | |------|-------------| | woo_list_coupons | List all coupons | | woo_get_coupon | Get a single coupon | | woo_create_coupon | Create a new coupon | | woo_update_coupon | Update a coupon | | woo_delete_coupon | Delete a coupon |

Product Reviews (5 tools)

| Tool | Description | |------|-------------| | woo_list_product_reviews | List all product reviews | | woo_get_product_review | Get a single review | | woo_create_product_review | Create a product review | | woo_update_product_review | Update a product review | | woo_delete_product_review | Delete a product review |

Taxonomy (10 tools)

| Tool | Description | |------|-------------| | woo_list_categories | List product categories | | woo_get_category | Get a single category | | woo_create_category | Create a product category | | woo_update_category | Update a product category | | woo_delete_category | Delete a product category | | woo_list_tags | List product tags | | woo_get_tag | Get a single tag | | woo_create_tag | Create a product tag | | woo_update_tag | Update a product tag | | woo_delete_tag | Delete a product tag |

Tax (8 tools)

| Tool | Description | |------|-------------| | woo_list_tax_rates | List all tax rates | | woo_get_tax_rate | Get a single tax rate | | woo_create_tax_rate | Create a tax rate | | woo_update_tax_rate | Update a tax rate | | woo_delete_tax_rate | Delete a tax rate | | woo_list_tax_classes | List tax classes | | woo_create_tax_class | Create a tax class | | woo_delete_tax_class | Delete a tax class |

Shipping (6 tools)

| Tool | Description | |------|-------------| | woo_list_shipping_zones | List all shipping zones | | woo_list_shipping_classes | List shipping classes | | woo_get_shipping_class | Get a single shipping class | | woo_create_shipping_class | Create a shipping class | | woo_update_shipping_class | Update a shipping class | | woo_delete_shipping_class | Delete a shipping class |

Webhooks (5 tools)

| Tool | Description | |------|-------------| | woo_list_webhooks | List all webhooks | | woo_get_webhook | Get a single webhook | | woo_create_webhook | Create a webhook | | woo_update_webhook | Update a webhook | | woo_delete_webhook | Delete a webhook |

Reports (3 tools)

| Tool | Description | |------|-------------| | woo_get_reports_sales | Get sales reports | | woo_get_reports_top_sellers | Get top-selling products | | woo_get_reports_totals | Get report totals (orders, products, customers) |

Settings & System (10 tools)

| Tool | Description | |------|-------------| | woo_get_settings | Get store settings by group | | woo_update_setting | Update a store setting | | woo_get_payment_gateways | List payment gateways | | woo_update_payment_gateway | Update a payment gateway | | woo_get_system_status | Get system status info | | woo_list_system_tools | List available system tools | | woo_run_system_tool | Run a system tool | | woo_list_data | List data endpoints | | woo_get_data_item | Get a data item | | woo_get_current_currency | Get the store's current currency |

Batch & Workflows (4 tools)

| Tool | Description | |------|-------------| | woo_batch_update | Batch create, update, or delete resources | | woo_store_dashboard | Get a complete store overview (orders, revenue, products) | | woo_create_full_product | Create a product with all details in one call | | woo_process_order | Process order workflow (fulfill, complete, etc.) |

Examples

You: "Show me my store dashboard"
AI: Uses woo_store_dashboard to get an overview of recent orders, revenue, and inventory.

You: "Create a new T-shirt product with sizes S, M, L"
AI: Uses woo_create_full_product to create the product with variations for each size.

You: "List all pending orders"
AI: Uses woo_list_orders with status filter set to "pending".

Development

# Build
npx turbo build --filter=@cmsmcp/woocommerce

# Test
npx turbo test --filter=@cmsmcp/woocommerce

# Dev mode
npx turbo dev --filter=@cmsmcp/woocommerce

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node packages/woocommerce-mcp/dist/index.js

License

MIT