List WooCommerce Products
woocommerce_list_productsSearch and filter WooCommerce products by name, SKU, status, type, price, stock, and more. Returns paginated list with key details.
Instructions
Search and list products in the WooCommerce store catalog.
Supports filtering by search term, SKU, status, type, category, tag, stock status, sale status, and price range. Does NOT return product variations for variable products - use woocommerce_list_product_variations for those.
Args:
search (string, optional): Match against name/SKU/description
sku (string, optional): Exact SKU match
status ('any'|'draft'|'pending'|'private'|'publish'): default 'any'
type ('simple'|'grouped'|'external'|'variable'): optional
category (string, optional): category ID(s), comma-separated
tag (string, optional): tag ID(s), comma-separated
stock_status ('instock'|'outofstock'|'onbackorder'): optional
featured (boolean, optional)
on_sale (boolean, optional)
min_price / max_price (string, optional): numeric string bounds
orderby / order: sorting controls
page / per_page: pagination (default page=1, per_page=20, max 100)
response_format ('markdown'|'json'): default 'markdown'
Returns: paginated list of products with id, name, sku, type, status, pricing, stock, and categories.
Examples:
Use when: "find all out of stock products" -> stock_status="outofstock"
Use when: "show products under $20 on sale" -> on_sale=true, max_price="20.00"
Don't use when: you need details of one known product ID (use woocommerce_get_product)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sku | No | Filter by an exact SKU | |
| tag | No | Filter by tag ID (comma-separated for multiple) | |
| page | No | Page number to retrieve, 1-based (default: 1) | |
| type | No | Filter by product type | |
| order | No | Sort direction (default: desc) | desc |
| search | No | Search term to match against product name/SKU/description | |
| status | No | Filter by product status (default: any) | any |
| on_sale | No | Filter to only products currently on sale | |
| orderby | No | Field to sort results by (default: date) | date |
| category | No | Filter by category ID (comma-separated for multiple) | |
| featured | No | Filter to only featured (true) or non-featured (false) products | |
| per_page | No | Number of results per page, 1-100 (default: 20) | |
| max_price | No | Maximum price filter (numeric string, e.g. '99.99') | |
| min_price | No | Minimum price filter (numeric string, e.g. '10.00') | |
| stock_status | No | Filter by stock status | |
| response_format | No | Output format: 'markdown' for human-readable text or 'json' for machine-readable structured data | markdown |