WooCommerce MCP Server
The WooCommerce MCP Server is a production-grade tool providing 73 REST API tools for comprehensive WooCommerce store management.
Store Management & Diagnostics
Validate connection, retrieve store info (name, URL, currency, timezone)
Access system status: WooCommerce/WordPress versions, plugins, and server environment
Read store configuration settings by group (general, products, tax, etc.)
List supported currencies and countries
Product Operations
Full CRUD for products (simple, variable, grouped, external)
Manage categories, tags, attributes, attribute terms, variations, and reviews
Search by name/SKU; filter by status, category, or sales status
Monitor low-stock and out-of-stock inventory
Order Management
Create, update, and delete orders; filter by status, customer, or date range
Update order status (pending, processing, completed, cancelled, etc.)
Add internal or customer-facing order notes; create and list refunds
Customer Management
Full CRUD for customers; search by name or email
View billing/shipping addresses and order history
Coupons
Create, list, update, and delete coupons (percent, fixed cart, fixed product) with usage limits and expiry dates
Reports & Analytics
Sales reports by period (week, month, year, or custom range)
Top-selling products; order counts by status and product counts by type
Shipping, Taxes & Payments
List shipping zones/methods, payment gateways, tax rates, tax classes, and shipping classes
Webhooks
Create, list, update, and delete webhooks for real-time event notifications (orders, products, customers, coupons)
Batch Operations
Bulk update multiple products or orders in a single API call
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 -- 73 tools for products, variations, attributes, orders, customers, coupons, reviews, reports, shipping, payments, webhooks, batch operations, inventory, 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 73 production-ready tools covering the entire WooCommerce REST API v3 with full CRUD on every core resource.
Features
73 tools across 18 categories -- the most comprehensive WooCommerce MCP server available
Full CRUD for products, variations, attributes, attribute terms, categories, tags, reviews, orders, customers, coupons, and webhooks
Inventory management -- list out-of-stock and low-stock products
Batch operations -- bulk update products and orders in a single call
Reports & analytics -- sales reports, top sellers, order/product totals
Store configuration -- settings, tax classes, shipping classes, currencies, countries
Webhook management -- create, update, list, delete webhooks for real-time events
System diagnostics -- WooCommerce/WordPress versions, plugins, server environment
Error-safe -- every tool wrapped with error handling, never crashes on API failures
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"
}
}
}
}Use with Claude Code
claude mcp add woocommerce -- mcp-woocommerceThen set environment variables in your shell before running Claude Code.
Tools (73)
Store (1)
Tool | Description |
| Validate connection and get store info |
Products (8)
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 products by stock status (out-of-stock, on-backorder) |
Product Categories (4)
Tool | Description |
| List categories with hierarchy |
| Create a category (with optional parent for subcategories) |
| Update category name, description, slug, parent |
| Delete a category |
Product Variations (5)
Tool | Description |
| List all variations for a variable product |
| Full variation details (pricing, stock, attributes) |
| Create a variation with attributes and pricing |
| Update variation price, stock, status |
| Delete a variation |
Product Attributes (5)
Tool | Description |
| List all attributes (e.g. Color, Size) |
| Get attribute details with its terms |
| Create an attribute (select or text type) |
| Update attribute name, slug, ordering |
| Delete an attribute from all products |
Attribute Terms (4)
Tool | Description |
| List terms for an attribute (e.g. Red, Blue for Color) |
| Add a term to an attribute |
| Update a term's name, slug, description |
| Delete a term |
Product Tags (3)
Tool | Description |
| List tags with optional search |
| Create a product tag |
| Delete a product tag |
Product Reviews (4)
Tool | Description |
| List reviews (filter by product or status) |
| Full review details |
| Create a review with rating |
| Delete a review |
Orders (10)
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.) |
| Edit order billing/shipping addresses and customer note |
| Delete or trash an order |
| Get all notes on an order |
| Add staff or customer-facing notes |
| Issue a refund |
| List all refunds for an order |
Customers (6)
Tool | Description |
| List customers with filters (role, search) |
| Full customer details with addresses and order stats |
| Create a new customer |
| Update customer info, billing/shipping addresses |
| Delete a customer (with optional order reassignment) |
| Search by name or email |
Coupons (5)
Tool | Description |
| List coupons with search |
| Full coupon details (restrictions, limits, usage) |
| Create percent, fixed cart, or fixed product coupons |
| Update coupon amount, expiry, limits, etc. |
| 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 |
Settings (1)
Tool | Description |
| Read store settings by group (general, products, tax, etc.) |
Shipping & Payments (5)
Tool | Description |
| Shipping zones with their methods |
| Payment gateways with enabled status |
| All configured tax rates |
| Tax classes (standard, reduced, zero rate) |
| Product shipping classes |
Webhooks (4)
Tool | Description |
| List all webhooks |
| Create webhooks for order/product/customer events |
| Update webhook URL, topic, status |
| Delete a webhook |
Batch Operations (2)
Tool | Description |
| Bulk update multiple products in one call |
| Bulk update multiple orders in one call |
Data (2)
Tool | Description |
| All supported currencies with codes and symbols |
| All countries with states/provinces |
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
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/AlexlaGuardia/mcp-woocommerce'
If you have feedback or need assistance with the MCP directory API, please join our Discord server