Get sales report
Sales totals for a period: gross and net sales, orders, items, tax, shipping, refunds and coupons used.
MCP tool woocommerce_read → get_sales_report
read
Returns the store's sales report for one period, with the totals and a day-by-day list. Pass period for week, month, last_month or year, or a custom range with date_min and date_max in YYYY-MM-DD. Without either, the report covers the current day only. The WooCommerce Analytics screens count by a Date Type setting (created, paid or completed, default Date Paid), so numbers read there can differ from a report built on another date.
Parameters
| Name | Type | Description |
|---|---|---|
| period enum | enum | week, month, last_month or year. |
| date_min date | date | Start date, YYYY-MM-DD. Use with date_max. |
| date_max date | date | End date, YYYY-MM-DD. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "woocommerce_read",
"arguments": {
"operation": "get_sales_report",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"period": {
"date_min": "2026-10-05",
"date_max": "2026-10-11"
},
"total_sales": "1860.00",
"net_sales": "1744.00",
"average_sales": "249.14",
"total_orders": 31,
"total_items": 53,
"total_tax": "92.00",
"total_shipping": "88.00",
"total_refunds": 2,
"total_discount": 3,
"totals": [
{
"date": "2026-10-05",
"sales": "310.00",
"orders": 5,
"items": 9
},
{
"date": "2026-10-06",
"sales": "245.00",
"orders": 4,
"items": 7
},
{
"date": "2026-10-07",
"sales": "280.00",
"orders": 5,
"items": 8
},
{
"date": "2026-10-08",
"sales": "190.00",
"orders": 3,
"items": 5
},
{
"date": "2026-10-09",
"sales": "260.00",
"orders": 4,
"items": 7
},
{
"date": "2026-10-10",
"sales": "330.00",
"orders": 6,
"items": 10
},
{
"date": "2026-10-11",
"sales": "245.00",
"orders": 4,
"items": 7
}
]
},
"isError": false
}