List WooCommerce Customers
woocommerce_list_customersSearch and filter registered customers by email, name, or role, returning ID, email, order count, and total spent.
Instructions
Search and list registered customers (does not include guest checkout customers, who aren't stored as customer records).
Args:
search (string, optional): match against name/email/username
email (string, optional): exact match
role (string, optional): WordPress role filter
orderby / order: sorting (default name/asc)
page / per_page: pagination (default page=1, per_page=20, max 100)
response_format ('markdown'|'json'): default 'markdown'
Returns: paginated list of customers with id, email, name, order count, and total spent.
Examples:
Use when: "find the customer with email jane@example.com" -> email="jane@example.com"
Don't use when: looking up who placed a guest order (check the order's billing details instead)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number to retrieve, 1-based (default: 1) | |
| role | No | Filter by WordPress user role, e.g. 'customer', 'subscriber' | |
| No | Filter by exact email address | ||
| order | No | Sort direction (default: asc) | asc |
| search | No | Search term to match against name/email/username | |
| orderby | No | Sort field (default: name) | name |
| per_page | No | Number of results per page, 1-100 (default: 20) | |
| response_format | No | Output format: 'markdown' for human-readable text or 'json' for machine-readable structured data | markdown |