Add order note
Add a private note for your team or a note the customer sees and is emailed.
MCP tool woocommerce_write → add_order_note
write Confirm
Adds a note to an order. By default the note is private and only staff see it. With customer_note set to true, WooCommerce shows the note to the customer and notifies them. Notes cannot be edited by this tool, so a wrong customer note stays on the order. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| order_id integer required | integer | Order ID from list_orders. |
| note string required | string | The note text. |
| customer_note boolean | boolean | true shows the note to the customer and notifies them. Default: false. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "woocommerce_write",
"arguments": {
"operation": "add_order_note",
"arguments": {
"order_id": 1,
"note": "note"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"note_id": 9131,
"order_id": 1043,
"note": "Tracking number 1Z999AA10123456791",
"customer_note": true,
"date_created": "2026-10-15T08:03:00Z"
},
"isError": false
}