WooCommerce MCP
Manage multiple WooCommerce stores from an AI client, with previewed writes
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 0.6.0
- Listing updated
- 3 days ago
About WooCommerce MCP
WooCommerce MCP is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.
Stores are read-only until you switch writing on. Even then, a write tool first returns the exact REST request it would send, and only applies it when called again with confirm: true. If the arguments or the store data changed since the preview, the confirm is refused. An optional approval secret goes further: a confirm then needs a short-lived, single-use token signed outside the agent's reach, so the agent cannot approve its own changes.
The server covers 47 tools across products, orders, fulfillment, customers, coupons, webhooks, shipping, taxes and analytics. It can issue partial or line-item refunds, batch-update up to 100 products, adjust prices by percentage or fixed amount, report sales by day, week or month, and flag low stock including variations. Each store has its own credentials and read-only switch, and every write attempt lands in a JSON-lines audit log.
It runs locally over stdio through npm, or as a remote service over streamable HTTP with bearer tokens or OAuth 2.0 token introspection, and ships a Docker image. Settings include optional masking of customer names, emails and phones, allow and deny lists for tools, per-store rate limiting, and OpenTelemetry traces.
Install
Run in a terminal
claude mcp add woocommerce-mcp --env WOOCOMMERCE_URL='<WOOCOMMERCE_URL>' --env WOOCOMMERCE_CONSUMER_KEY='<WOOCOMMERCE_CONSUMER_KEY>' --env WOOCOMMERCE_CONSUMER_SECRET='<WOOCOMMERCE_CONSUMER_SECRET>' -- npx -y @sadrmanesh/woocommerce-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"woocommerce-mcp": {
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
"WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
"WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"woocommerce-mcp": {
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
"WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
"WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"woocommerce-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
"WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
"WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"woocommerce-mcp": {
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
"WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
"WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"woocommerce-mcp": {
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "<WOOCOMMERCE_URL>",
"WOOCOMMERCE_CONSUMER_KEY": "<WOOCOMMERCE_CONSUMER_KEY>",
"WOOCOMMERCE_CONSUMER_SECRET": "<WOOCOMMERCE_CONSUMER_SECRET>"
}
}
}
}Configuration
WOOCOMMERCE_URLStore origin, such as https://store.example.comRequiredWOOCOMMERCE_CONSUMER_KEYWooCommerce REST API consumer key (ck_...)RequiredWOOCOMMERCE_CONSUMER_SECRETWooCommerce REST API consumer secret (cs_...)RequiredWOOCOMMERCE_READ_ONLYRefuse every write tool. Set to false to allow writesWOOCOMMERCE_REDACT_PIIMask customer names, emails, phones, and addresses in resultsWOOCOMMERCE_TOOLS_DENYComma-separated tool names or patterns to hide, such as delete_*
What it does
- Preview before write
- Write tools return the exact REST request first and apply it only on a second call with confirm.
- Multi-store support
- Configure any number of stores, each with its own credentials and read-only switch.
- Refunds and bulk edits
- Partial or line-item refunds, batch updates of up to 100 products, and price adjustments.
- Sales analytics
- Sales by day, week or month, top products, payment methods and a low-stock report.
- Audit log
- One JSON line per write attempt, linking each confirmed write to its preview.
- PII redaction and tool filters
- Mask customer details and hide tools with deny patterns such as delete_*.
- Local or remote
- Run over stdio with npx, or serve over streamable HTTP with bearer or OAuth auth.
Good for
- Check which products are low on stock, including variations
- Refund part of an order after reviewing the preview
- Raise prices across a product range by a percentage
- Run a weekly sales briefing across several stores
- Mark an order shipped with tracking and email the customer
Pricing
Open source
Prices change. Check sadrmanesh.github.io before you buy.
WooCommerce MCP FAQ
Can the server change my store without asking?
No. Stores start read-only, and when writing is allowed each change is previewed and needs a confirming second call.
What credentials does it need?
A store URL plus a WooCommerce REST API consumer key and secret.
Can I hide customer personal data from the AI?
Yes. An optional setting masks customer names, emails, phones and addresses in results.
How can I stop it from using destructive tools?
Set a deny list of tool names or patterns, for example delete_*, per deployment or per store.
Is WooCommerce MCP free?
Yes. WooCommerce MCP is open source, so you can use and self-host it for free.
How do I add WooCommerce MCP to Claude Code?
Run this command in your terminal: claude mcp add woocommerce-mcp --env WOOCOMMERCE_URL='<WOOCOMMERCE_URL>' --env WOOCOMMERCE_CONSUMER_KEY='<WOOCOMMERCE_CONSUMER_KEY>' --env WOOCOMMERCE_CONSUMER_SECRET='<WOOCOMMERCE_CONSUMER_SECRET>' -- npx -y @sadrmanesh/woocommerce-mcp
What are the best alternatives to WooCommerce MCP?
The closest alternatives to WooCommerce MCP are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).
Alternatives to WooCommerce MCP
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce

Renta
MCP serverRemote MCP server for running an outdoor rental shop on Renta from an AI client
- Remote
- Paid
- E-commerce

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce

repairinfo
MCP serverRepairability scores and spare-parts years for EU appliances and electronics
- 4 tools
- Remote
- Freemium
- Analytics and data