Enables programmatic interaction with Woo e-commerce stores, covering inventory management, order fulfillment, and customer tracking.
Provides 34 tools for the WooCommerce REST API, supporting full CRUD operations for products, orders, customers, and coupons, along with sales reports, analytics, and store management.
Connects to WordPress environments to manage WooCommerce store data and access system health diagnostics, including version details and plugin statuses.
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-woocommerceConfigure
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-woocommerceOr run as a module:
python -m mcp_woocommerceUse 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 |
| Validate connection and get store info |
Products (7)
Tool | Description |
| List products with filters (status, category, search, on_sale) |
| Full product details (pricing, inventory, images, attributes) |
| Create a product (simple, variable, grouped, external) |
| Update product fields (price, stock, status, etc.) |
| Delete or trash a product |
| Search by name or SKU |
| List categories with hierarchy |
Orders (7)
Tool | Description |
| List orders with filters (status, customer, date range) |
| Full order details (items, billing, shipping, payment) |
| Create an order with line items |
| Change order status (pending, processing, completed, etc.) |
| Get all notes on an order |
| Add staff or customer-facing notes |
| Issue a refund |
Customers (4)
Tool | Description |
| List customers with filters (role, search) |
| Full customer details with addresses and order stats |
| Create a new customer |
| Search by name or email |
Coupons (4)
Tool | Description |
| List coupons with search |
| Full coupon details (restrictions, limits, usage) |
| Create percent, fixed cart, or fixed product coupons |
| Delete a coupon |
Reports (4)
Tool | Description |
| Sales totals by period (week, month, year, custom range) |
| Top-selling products by period |
| Order counts by status |
| Product counts by type |
Shipping & Payments (3)
Tool | Description |
| Shipping zones with their methods |
| Payment gateways with enabled status |
| All configured tax rates |
Webhooks (3)
Tool | Description |
| List all webhooks |
| Create webhooks for order/product/customer events |
| Delete a webhook |
System (1)
Tool | Description |
| 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
