woocommerce-claude

WooCommerce for Claude

Make any WooCommerce store AI-operable.

WooCommerce core already has native MCP support (in developer preview) — AI tools can connect and perform basic product and order operations. That's the plumbing.

WooCommerce for Claude adds the intelligence layer on top: structured store knowledge, AI readiness scoring, analytics insights, and a library of Skills that make a Woo store genuinely useful to AI.

Core MCP: "Claude can talk to your store." WooCommerce for Claude: "Claude can understand your store and help you run it better."

---

Performance

For a typical WooCommerce store, the plugin's load is lighter than loading the WC Analytics dashboard a few times an hour. It queries WooCommerce's pre-aggregated analytics lookup tables, caches every result for an hour, and runs nothing in the background — no cron, no polling, no sync jobs.

---

Connect your Woo store to an AI client

Prerequisites

• A self-hosted WooCommerce store (version 8.0+)
• Node.js 18+ on the machine running your MCP client
• An MCP-capable client (Claude Desktop, Claude Code, or any other MCP client)

Claude Desktop — one click

1. Install and activate WooCommerce for Claude. For local dev: pnpm exec wp-env start.
2. Open WooCommerce → Settings → WooCommerce for Claude in WP admin (or click Set up Claude in the post-activation notice).
3. If WooCommerce MCP integration isn't on yet, click Enable WooCommerce MCP integration.
4. Click Download WooCommerce for Claude, then double-click the downloaded .mcpb file. Claude Desktop registers WooCommerce for Claude automatically — no copy-paste, no JSON, no API key wrangling.

The setup page auto-creates a Read-only WooCommerce REST API key (named "WooCommerce for Claude — Claude Desktop") and embeds it in the bundle. Switch to Read + Write on the same page if you want Claude to be able to create or edit products and orders. The bundle contains a credential — if it leaks, click Regenerate on the same page to revoke it instantly.

Other MCP clients (Claude Code, Cursor, …)

Same setup page, Manual Setup card. Pick your client from the dropdown — WooCommerce for Claude renders a copy-pasteable JSON snippet (or a claude mcp add … one-liner for Claude Code) with this store's URL and the auto-generated API key already filled in.

Manual / scripted setup

If you'd rather configure everything yourself — for example to drop the admin page from your workflow, ship via WP-CLI, or wire a CI deploy — the manual flow is:

1. Create an API key

In WooCommerce > Settings > Advanced > REST API, create a new key with Read or Read/Write permissions. Save the consumer key (ck_...) and consumer secret (cs_...). The MCP endpoint authenticates with the standard WooCommerce REST API key flow — ck_... as the username and cs_... as the password over HTTP Basic auth. HTTPS is required for production; HTTP works for local dev.

2. Point your MCP client at the endpoint

The recommended path is to connect through @automattic/mcp-wordpress-remote — a lightweight local proxy that translates stdio-based MCP (what most clients speak) into HTTP requests to WordPress. This works across Claude Desktop, Claude Code, and any other MCP client.

Claude Code — one command:

claude mcp add woocommerce-claude \
  --env WP_API_URL=https://yourstore.com/wp-json/woocommerce-claude/mcp \
  --env WP_API_USERNAME=ck_xxx \
  --env WP_API_PASSWORD=cs_xxx \
  -- npx -y @automattic/mcp-wordpress-remote@0.3.0

Claude Desktop / Cursor / generic — add to your MCP config manually:

{
  "mcpServers": {
    "woocommerce-claude": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@0.3.0"],
      "env": {
        "WP_API_URL": "https://yourstore.com/wp-json/woocommerce-claude/mcp",
        "WP_API_USERNAME": "ck_xxx",
        "WP_API_PASSWORD": "cs_xxx"
      }
    }
  }
}

Having trouble? See the mcp-wordpress-remote troubleshooting guide.

If your MCP client supports HTTP transport natively (some do, many don't), you can point it straight at the endpoint without the proxy. Use HTTP Basic auth with the consumer key as the username and consumer secret as the password.

Restart your client and talk to your store

You now have these tools available (plus the nine built-in woocommerce-* CRUD tools from WC core):