WooCommerce MCP server
WooCommerce's official MCP integration lets agents query and manage products and orders in your store.
WooCommerce MCP is WooCommerce's official, native Model Context Protocol integration that lets AI assistants operate a store through a standardized contract. It is built on the WordPress MCP architecture and ships a canonical set of WooCommerce abilities introduced in WooCommerce 10.9: querying products with filtering and sorting, creating, updating, and deleting products, querying orders by status, customer, and date range, updating an order's status with an optional note, and adding a note to an order. Each ability carries strict input and output schemas, WooCommerce-aware enums, and permission callbacks, so an agent can run real store operations within the store's existing roles and capabilities.
The canonical connection uses a local proxy, npx -y @automattic/mcp-wordpress-remote@latest, which translates stdio MCP traffic into calls to your store's MCP endpoint at https://yourstore.com/wp-json/woocommerce/mcp. Authentication uses WooCommerce REST API keys passed in an X-MCP-API-Key header formatted as consumer_key:consumer_secret, with read, write, or read/write scope chosen when you generate the keys. The MCP integration is enabled behind a feature flag in WooCommerce settings and is currently a developer preview, so APIs may evolve as it moves toward general availability.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"woocommerce": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "<WP_API_URL>",
"CUSTOM_HEADERS": "<CUSTOM_HEADERS>"
}
}
}
}claude mcp add woocommerce -- npx -y @automattic/mcp-wordpress-remote@latestAvailable tools
| Tool | Description |
|---|---|
| woocommerce/products-query | Queries products with filtering and sorting options. |
| woocommerce/product-create | Creates a new product with a specified type and attributes. |
| woocommerce/product-update | Modifies an existing product's details and settings. |
| woocommerce/product-delete | Removes a product by moving it to trash or deleting it permanently. |
| woocommerce/orders-query | Retrieves orders using filters like status, customer ID, and date ranges. |
| woocommerce/order-update-status | Changes an order's status and optionally includes a change note. |
| woocommerce/order-add-note | Attaches a note to an order, attributed to the current user. |
Required configuration
- WP_API_URLRequired
Your store's WooCommerce MCP endpoint, e.g. https://yourstore.com/wp-json/woocommerce/mcp.
- CUSTOM_HEADERSRequired
JSON object carrying the auth header, e.g. {"X-MCP-API-Key": "CONSUMER_KEY:CONSUMER_SECRET"} using WooCommerce REST API keys.
What you can do with it
Manage the catalog conversationally
An agent queries products, creates a new one, or updates a price on request, so a store owner can change the catalog by describing what they want instead of clicking through wp-admin.
Handle orders and customer notes
The agent queries recent orders by status or customer, updates an order's status, and adds a note to record what happened for the rest of the team.
FAQ
- Is it free?
- Yes. WooCommerce and its MCP integration are free, open-source plugins; the @automattic/mcp-wordpress-remote proxy is free to run. You only pay for your own hosting.
- Does it support remote/OAuth?
- It connects through a local stdio proxy (@automattic/mcp-wordpress-remote) to your store's MCP endpoint, authenticating with WooCommerce REST API keys in an X-MCP-API-Key header rather than OAuth.
- Is it production-ready?
- It is an official WooCommerce feature but a developer preview, enabled behind a feature flag in WooCommerce settings. Implementation details and the canonical ability set may change as it moves toward general availability.