WooCommerce MCP Server
About
Production-grade MCP server for the WooCommerce REST API. 34 tools for products, orders, customers, coupons, reports, shipping, payments, webhooks, and system status. Built for the 5 million+ stores running WooCommerce.
Details
- Author
- AlexlaGuardia
- Downloads
- 330
- Categories
- Other
Jump to
- 34 tools across 8 categories (products, orders, customers, etc.)
- Full CRUD for products, orders, customers, and coupons
- Sales reports, top sellers, order totals, and product analytics
- Webhook management for real‑time event handling
- System diagnostics — WordPress/WooCommerce versions and plugins
- Simple auth using consumer key and secret over HTTPS
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
WooCommerce MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via pip install mcp-woocommerce, set the environment variables WOOCOMMERCE_URL, WOOCOMMERCE_KEY, and WOOCOMMERCE_SECRET, then run mcp-woocommerce or python -m mcp_woocommerce. For Claude Desktop, add the provided JSON configuration to claude_desktop_config.json.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"woocommerce mcp server": {
"woocommerce": {
"command": "mcp-woocommerce",
"env": {
"WOOCOMMERCE_URL": "https://yourstore.com",
"WOOCOMMERCE_KEY": "ck_your_consumer_key",
"WOOCOMMERCE_SECRET": "cs_your_consumer_secret"
}
}
}
}
}McpServers
{
"woocommerce": {
"command": "mcp-woocommerce",
"env": {
"WOOCOMMERCE_URL": "https://yourstore.com",
"WOOCOMMERCE_KEY": "ck_your_consumer_key",
"WOOCOMMERCE_SECRET": "cs_your_consumer_secret"
}
}
}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.
1. Go to WordPress Admin > WooCommerce > Settings > Advanced > REST API
2. Click Add key
3. Set permissions to Read/Write
4. 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
