WooCommerce MCP Server

Read from the package source without running it. The installed server may list more.

• add_shipping_zone_method

  Add a shipping method to a zone. Valid method_id values: 'flat_rate', 'free_shipping', 'local_pickup'. Configure rates via settings after adding.

• batch_update_attribute_termswrite action

  Batch create, update, or delete attribute terms in a single request. More efficient than individual create/delete calls for multiple terms.

• batch_update_variationswrite action

  Batch create, update, or delete variations in a single request. More efficient than individual calls for setting up a variable product.

• cleanup_orphaned_media

  Find orphaned media not used by any product or category. Dry run by default; set delete=true to remove them. Scans all products and categories.

• create_attributewrite action

  Create a global product attribute. After creating, use create_attribute_term to add values (e.g. 500g, 1kg for a Weight attribute).

• create_attribute_termwrite action

  Add a new value to a product attribute (e.g. add '2kg' to Weight). Use batch_update_attribute_terms for multiple values at once.

• create_brandwrite action

  Create a product brand. Brands are hierarchical and can have images. Assign to products via update_product with brands array.

• create_categorywrite action

  Create a product category. Set parent ID to create a subcategory. Categories are hierarchical.

• create_couponwrite action

  Create a discount coupon. Code must be unique. Supports percent, fixed cart, and fixed product discount types. Use fields param to request only needed fields.

• create_customerwrite action

  Create a new customer account. Email is required and must be unique. Use fields param to request only needed fields.

• create_orderwrite action

  Create a new order. Requires line_items with product_id and quantity. Use variation_id for variable product variants.

• create_order_notewrite action

  Add a note to an order. Set customer_note=true to send an email notification to the customer with the note content. Default is a private admin note.

• create_order_refundwrite action

  Create a refund for an order. Can refund full or partial amount. Set api_refund=true (default) to automatically refund via payment gateway, or false for manual refund.

• create_productwrite action

  Create a new WooCommerce product. For variable products, set type='variable' and include attributes array, then use create_variation to add variants.

• create_shipping_classwrite action

  Create a product shipping class. Assign to products via update_product to group similar shipping needs (e.g. 'bulky', 'fragile').

• create_shipping_zonewrite action

  Create a new shipping zone. After creating, add locations and shipping methods to it.

• create_tagwrite action

  Create a product tag. Tags are flat labels like 'Bestseller' or 'New Arrival' — unlike categories, they have no hierarchy.

• create_tax_classwrite action

  Create a custom tax class. After creating, add tax rates to it. Example: 'GST 5%' for food items.

• create_tax_ratewrite action

  Create a tax rate. Set country/state/postcode for region, rate as percentage string (e.g. '18.0000'), and class for tax class.

• create_variationwrite action

  Create a variation for a variable product. Parent product must have type='variable' with matching attributes. Use batch_update_variations for multiple at once.

• create_webhookwrite action

  Create a webhook. Topic format: 'resource.event' (e.g. 'order.created', 'product.updated', 'coupon.deleted'). Resources: order, product, customer, coupon. Events: created, updated, deleted, restored.

• delete_attributewrite action

  Delete a global product attribute and all its terms. Also removes the attribute from all products that use it.

• delete_attribute_termwrite action

  Delete a value from a product attribute. Removes the term from all products using it.

• delete_brandwrite action

  Delete a product brand. Does NOT delete products with this brand; they simply lose the brand association.

• delete_categorywrite action

  Delete a product category. Does NOT delete products in the category; they become uncategorized.

• delete_couponwrite action

  Delete a coupon. Moves to trash by default; set force=true to permanently delete.

• delete_mediawrite action

  Permanently delete a media item from WordPress. This is irreversible. Use cleanup_orphaned_media to find unused items first.

• delete_orderwrite action

  Delete an order. Moves to trash by default; set force=true to permanently delete.

• delete_order_notewrite action

  Delete a note from an order. This permanently removes the note.

• delete_order_refundwrite action

  Delete a refund record from an order. This removes the refund entry but does not reverse the payment — use with caution.

• delete_productwrite action

  Delete a product. Moves to trash by default; set force=true to permanently delete. Does not delete associated media.

• delete_product_reviewwrite action

  Delete a product review. By default moves to trash (force=false). Set force=true to permanently delete.

• delete_shipping_classwrite action

  Delete a product shipping class. Products using this class will revert to no shipping class.

• delete_shipping_zonewrite action

  Delete a shipping zone. This also removes all methods and locations in the zone.

• delete_shipping_zone_methodwrite action

  Remove a shipping method from a zone.

• delete_tagwrite action

  Delete a product tag. Does NOT affect products that had this tag; they simply lose the tag association.

• delete_tax_classwrite action

  Delete a tax class by slug. Cannot delete the Standard class. Rates in this class will be orphaned.

• delete_tax_ratewrite action

  Delete a tax rate. This is permanent and cannot be undone.

• get_attribute

  Get details of a global product attribute. Use list_attribute_terms with the attribute ID to see its values. Use fields param to request only needed fields.

• get_brand

  Get full details of a product brand including description, image, and product count. Use fields param to request only needed fields.

• get_category

  Get full details of a category including description and product count. Use fields param to request only needed fields.

• get_coupon

  Get full coupon details including usage limits, product restrictions, and expiry date. Use fields param to request only needed fields.

• get_customer

  Get full customer details including billing and shipping addresses, order history stats. Use fields param to request only needed fields.

• get_customer_totals

  Get customer counts grouped by WordPress role. Shows total registered customers and their roles.

• get_orderwrite action

  Get full details of a single order including billing, shipping, line items, and payment info. Use fields param to request only needed fields.

• get_order_totalswrite action

  Get order counts grouped by status (pending, processing, completed, etc.). Useful for a quick store health overview.

• get_payment_gateway

  Get full details of a payment gateway by ID. Common IDs: bacs (bank transfer), cheque, cod (cash on delivery), paypal, stripe, razorpay.

• get_product

  Get full details of a single product by ID. Returns more fields than list_products including description, tags, brands, and variations. Use fields param to request only needed fields.

• get_product_review

  Get full details of a product review by ID including reviewer email and verification status.

• get_product_totals

  Get product counts grouped by status (publish, draft, pending, private). Quick catalog size overview.

• get_sales_report

  Get sales report for a period. Returns total sales, orders, items, tax, shipping, refunds, and daily/weekly totals breakdown.

• get_settings

  Get all settings in a group. Common groups: 'general' (store address, currency), 'products' (measurements, reviews), 'tax' (tax options), 'shipping' (shipping options).

• get_shipping_zone

  Get a shipping zone by ID. Use list_shipping_zones to find zone IDs.

• get_system_status

  Get WooCommerce system status including environment, database, active plugins, theme, settings, and security info.

• get_tag

  Get full details of a product tag including description and product count. Use fields param to request only needed fields.

• get_tax_rate

  Get a single tax rate by ID with full details.

• get_top_sellers

  Get top-selling products ranked by quantity sold. Filterable by period or date range.

• get_variation

  Get full details of a single variation including price, stock, weight, and attributes. Use fields param to request only needed fields.

• get_webhook

  Get full details of a webhook by ID including secret and API version.

• list_attribute_terms

  List values (terms) for a product attribute, e.g. '500g', '1kg' for Weight. Use fields param to request only needed fields.

• list_attributes

  List global product attributes (e.g. Weight, Volume, Size). Use list_attribute_terms to see values for each attribute. Use fields param to request only needed fields.

• list_brands

  List product brands (WooCommerce 9.6+ core feature). Supports filtering by parent and hide_empty. Use fields param to request only needed fields.

• list_categories

  List product categories. Supports filtering by parent for subcategories, and hide_empty to skip unused categories. Use fields param to request only needed fields.

• list_countries

  List all countries available in WooCommerce with their states/provinces. Useful for setting up shipping zones and tax rules.

• list_coupons

  List discount coupons. Shows code, type (percent/fixed_cart/fixed_product), amount, and usage stats. Use fields param to request only needed fields.

• list_currencies

  List all currencies supported by WooCommerce with their codes and symbols.

• list_customers

  Search and filter customers by name, email, or role. Returns order count and total spent per customer. Use fields param to request only needed fields.

• list_media

  List WordPress media library items. Supports search and MIME type filtering (e.g. image/jpeg). Use fields param to request only needed fields.

• list_order_noteswrite action

  List all notes for an order. Includes both private admin notes and customer-visible notes. Use fields param to request only needed fields.

• list_order_refundswrite action

  List all refunds for an order. Shows refund amounts, reasons, and who processed them. Use fields param to request only needed fields.

• list_orders

  Search and filter orders. Supports filtering by status, customer, date range, and search term. Use fields param to request only needed fields.

• list_payment_gateways

  List all available payment gateways. Gateways are provided by plugins and cannot be created or deleted via API.

• list_product_reviews

  List product reviews. Filter by product IDs, status, or search term. Use fields param to request only needed fields.

• list_products

  Search and filter the product catalog. Supports filtering by status, category, tag, type, price range, and search term. Use fields param to request only needed fields.

• list_setting_groups

  List all WooCommerce setting groups. Groups include: general, products, tax, shipping, checkout, account, email, advanced. Use group ID with get_settings to see options.

• list_shipping_classes

  List product shipping classes. Classes group products with similar shipping requirements (e.g. heavy, fragile).

• list_shipping_zone_methods

  List shipping methods for a zone. Methods define how items are shipped (flat rate, free shipping, local pickup).

• list_shipping_zones

  List all shipping zones. Zones define geographic regions with specific shipping methods and rates.

• list_system_tools

  List available system tools (e.g. clear_transients, recount_terms, db_update_routine). These are maintenance utilities.

• list_tags

  List product tags. Tags are flat labels (no hierarchy). Use hide_empty to skip unused tags. Use fields param to request only needed fields.

• list_tax_classes

  List all tax classes. WooCommerce includes 'Standard', 'Reduced rate', and 'Zero rate' by default. Tax classes group tax rates.

• list_tax_rates

  List tax rates. Filter by tax class to see rates for a specific class. Each rate defines tax for a region.

• list_variations

  List all variations for a variable product. Each variation has its own price, SKU, and stock. Use fields param to request only needed fields.

• list_webhooks

  List webhooks. Webhooks send POST requests to a URL when store events occur (e.g. order.created, product.updated).

• run_system_toolwrite action

  Run a system maintenance tool. Common tools: clear_transients, clear_template_cache, recount_terms, db_update_routine, install_pages.

• update_brandwrite action

  Update a brand's name, slug, parent, description, or image. Only include fields you want to change.

• update_categorywrite action

  Update a category's name, slug, parent, description, or image. Only include fields you want to change.

• update_couponwrite action

  Update a coupon's code, amount, restrictions, or expiry. Only include fields you want to change. Use fields param to request only needed fields.

• update_customerwrite action

  Update customer details such as name, email, or addresses. Only include fields you want to change. Use fields param to request only needed fields.

• update_orderwrite action

  Update an order. Commonly used to change status (e.g. pending -> processing -> completed). See get_order_totals for valid statuses.

• update_payment_gatewaywrite action

  Update a payment gateway. Use to enable/disable gateways, change titles, or modify settings. Gateways cannot be created or deleted — they come from plugins.

• update_productwrite action

  Update an existing product. Only include fields you want to change. Note: setting images replaces all existing images.

• update_product_reviewwrite action

  Update a product review. Use to change status (approve/hold/spam/trash), edit review text, or modify rating.

• update_settingwrite action

  Update a single setting value. Use get_settings first to find the setting ID and valid options. Example: group_id='general', setting_id='woocommerce_currency', value='INR'.

• update_shipping_zonewrite action

  Update a shipping zone name or sort order.

• update_shipping_zone_methodwrite action

  Update a shipping method in a zone. Use to enable/disable, change title, order, or configure settings like cost.

• update_tagwrite action

  Update a product tag's name, slug, or description. Only include fields you want to change.

• update_tax_ratewrite action

  Update a tax rate. Only include fields you want to change.

• update_variationwrite action

  Update a variation's price, stock, SKU, or other details. Only include fields you want to change.

• update_webhookwrite action

  Update a webhook. Use to change delivery URL, topic, status (pause/resume), or secret.

• Code scan59 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 146 days ago8/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

82/100

higher than 75% of 2,174 E-commerce servers

Tools

100

the typical E-commerce server has 6

Tools that change things

56%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

2

more than 80% of 1,047 E-commerce servers

Downloads a week

99

more than 68% of 411 E-commerce servers with a package

WooCommerce MCP Server: common questions

Is WooCommerce MCP Server safe?

Mostly: it is graded B (82/100). Read the WooCommerce MCP Server safety report

How do I install WooCommerce MCP Server?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does WooCommerce MCP Server need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is WooCommerce MCP Server maintained?

The last commit was 183 days ago (2026-05-05). The latest release is v1.2.0.

What can I use instead of WooCommerce MCP Server?

Servers from other publishers that do the same job: Apify MCP server, Mneme Memory MCP server and Heimdall MCP server.

How does WooCommerce MCP Server compare with other E-commerce MCP servers?

safety score 82/100 (higher than 75% of 2,174 E-commerce servers); tools 100 (the typical E-commerce server has 6); tools that change things 56% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.