List customers
Customers with email, order count and total spent. Contains personal data.
MCP tool woocommerce_read → list_customers
read
Lists registered customers with their email, number of orders and total spent. Search by name or email. The result contains personal data of your customers, so it is returned only to a role that can see orders, and your agent should not forward it to tools you do not trust. Guest buyers appear on their orders, not here.
Parameters
| Name | Type | Description |
|---|---|---|
| search string | string | Part of a name or an email. |
| limit integer | integer | Results per page. Default: 10. |
| page integer | integer | Page number, starting at 1. Default: 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "woocommerce_read",
"arguments": {
"operation": "list_customers",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"customers": [
{
"customer_id": 58,
"name": "Jordan Lee",
"email": "jordan.lee@example.com",
"orders_count": 3,
"total_spent": "142.00"
}
],
"total": 1,
"total_pages": 1
},
"isError": false
}