Skip to main content
Glama

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-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"
      }
    }
  }
}

Use with Claude Code

claude mcp add woocommerce -- mcp-woocommerce

Then set environment variables in your shell before running Claude Code.

Tools (73)

Store (1)

Tool

Description

ping

Validate connection and get store info

Products (8)

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_low_stock_products

List products by stock status (out-of-stock, on-backorder)

Product Categories (4)

Tool

Description

list_product_categories

List categories with hierarchy

create_product_category

Create a category (with optional parent for subcategories)

update_product_category

Update category name, description, slug, parent

delete_product_category

Delete a category

Product Variations (5)

Tool

Description

list_product_variations

List all variations for a variable product

get_product_variation

Full variation details (pricing, stock, attributes)

create_product_variation

Create a variation with attributes and pricing

update_product_variation

Update variation price, stock, status

delete_product_variation

Delete a variation

Product Attributes (5)

Tool

Description

list_product_attributes

List all attributes (e.g. Color, Size)

get_product_attribute

Get attribute details with its terms

create_product_attribute

Create an attribute (select or text type)

update_product_attribute

Update attribute name, slug, ordering

delete_product_attribute

Delete an attribute from all products

Attribute Terms (4)

Tool

Description

list_attribute_terms

List terms for an attribute (e.g. Red, Blue for Color)

create_attribute_term

Add a term to an attribute

update_attribute_term

Update a term's name, slug, description

delete_attribute_term

Delete a term

Product Tags (3)

Tool

Description

list_product_tags

List tags with optional search

create_product_tag

Create a product tag

delete_product_tag

Delete a product tag

Product Reviews (4)

Tool

Description

list_product_reviews

List reviews (filter by product or status)

get_product_review

Full review details

create_product_review

Create a review with rating

delete_product_review

Delete a review

Orders (10)

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.)

update_order

Edit order billing/shipping addresses and customer note

delete_order

Delete or trash an order

list_order_notes

Get all notes on an order

create_order_note

Add staff or customer-facing notes

create_refund

Issue a refund

list_refunds

List all refunds for an order

Customers (6)

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

update_customer

Update customer info, billing/shipping addresses

delete_customer

Delete a customer (with optional order reassignment)

search_customers

Search by name or email

Coupons (5)

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

update_coupon

Update coupon amount, expiry, limits, etc.

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

Settings (1)

Tool

Description

get_store_settings

Read store settings by group (general, products, tax, etc.)

Shipping & Payments (5)

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

list_tax_classes

Tax classes (standard, reduced, zero rate)

list_shipping_classes

Product shipping classes

Webhooks (4)

Tool

Description

list_webhooks

List all webhooks

create_webhook

Create webhooks for order/product/customer events

update_webhook

Update webhook URL, topic, status

delete_webhook

Delete a webhook

Batch Operations (2)

Tool

Description

batch_update_products

Bulk update multiple products in one call

batch_update_orders

Bulk update multiple orders in one call

Data (2)

Tool

Description

list_currencies

All supported currencies with codes and symbols

list_countries

All countries with states/provinces

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

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