List Orders is a WordPress ability from WooCommerce — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List Orders
Read-onlyList and filter WooCommerce orders by status, customer, product, or date range.
Requires the WooCommerce plugin active on WordPress 6.9+, with the experimental 'mcp_integration' feature flag enabled (WooCommerce > Settings > Advanced > Features). Abilities are only registered for requests hitting WooCommerce's own /woocommerce/mcp REST endpoint, and each request must authenticate with a WooCommerce REST API key (consumer_key:consumer_secret) sent via the X-MCP-API-Key header over HTTPS — the key's read/write permission scope must match the HTTP method used.
What it does
This ability retrieves a paginated list of orders from the wc/v3/orders REST endpoint's collection query. You can filter by order status (or 'any', the default), a specific customer ID, or a specific product ID, and page through results using WordPress's standard collection parameters such as search, after, before, per_page, and page. It is registered with a readonly annotation, so it only reads order data and cannot modify orders.
See it in action
You ask your AI assistant
"List all orders with status 'processing' placed by customer ID 57 in the last week."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| status | string | No | Limit results to orders with a specific status, or 'any' (the default). |
| customer | integer | No | Limit results to orders placed by a specific customer ID. |
| product | integer | No | Limit results to orders containing a specific product ID. |
| search | string | No | Limit results to orders matching a search term. |
| after | string | No | Limit results to orders created after this ISO 8601 date. |
| before | string | No | Limit results to orders created before this ISO 8601 date. |
| per_page | integer | No | Number of orders to return per page. |
| page | integer | No | Which page of results to return. |
Returns
An object with a data array of order records (id, status, currency, totals, billing/shipping addresses, line items, and other fields from the WooCommerce order schema).
Permission
Registered as a read-only (GET) operation. Requires a WooCommerce REST API key sent via the X-MCP-API-Key header over HTTPS with 'read' or 'read_write' permission scope.
More WooCommerce abilities
Create Order
Create a new WooCommerce order with customer, billing/shipping, and line item details.
Create Product
Create a new WooCommerce product with a name, price, description, and other catalog attributes.
Delete Product
Permanently delete a product from the WooCommerce catalog.
Get Order
Fetch full details for a single WooCommerce order by its ID.
Get Product
Fetch full details for a single WooCommerce product by its ID.
List Products
List and filter your WooCommerce product catalog with paging, search, and attribute-based filters.