wppoland/woocommerce-mcp

A small, read-only Model Context Protocol server for **WordPress + WooCommerce**. It lets Claude (or any MCP client) answer questions about a live store — products, orders, sales, and blog posts — over the official REST APIs. No writes, no plugins to install on the store: it talks to the existing WordPress/WooCommerce REST endpoints.
Built and maintained by WPPoland, a senior WordPress developer working with WordPress since 2006. If you need this wired into a real store stack, we build WooCommerce ERP and API integrations and enterprise e-commerce architecture (headless, integrations, AI-ready data).
Tools
| Tool | What it does | Needs WooCommerce keys |
|------|--------------|:---:|
| list_products | List / search products (name, sku, price, stock, permalink) | yes |
| get_product | Full details for one product by id | yes |
| list_orders | Recent orders, newest first, optional status filter | yes |
| sales_report | Sales totals for a period (week / month / last_month / year) | yes |
| search_posts | Search published blog posts (public WP REST API) | no |
Everything is **read-only**. The server never creates, edits, or deletes anything in the store.
Install & build
From npm (package name is scoped - the unscoped woocommerce-mcp name is locked on the registry):
From source:
Configure
Set three environment variables:
| Var | Required | Example |
|-----|:---:|---------|
| WP_URL | yes | https://shop.example.com |
| WC_CONSUMER_KEY | for wc_* tools | ck_xxx |
| WC_CONSUMER_SECRET | for wc_* tools | cs_xxx |
Create the WooCommerce keys in **WooCommerce → Settings → Advanced → REST API → Add key** with **Read** permission. search_posts works without keys against any public WordPress site.
> The keys are sent to your own store over HTTPS as REST query auth. Use HTTPS, and give the key **Read** access only.
Use with Claude Desktop / Claude Code
Add to your MCP client config (e.g. claude_desktop_config.json):
Then ask things like *"What were last month's WooCommerce sales?"* or *"List the 5 most recent orders that are on hold."*
Docs on wppoland.com
- WooCommerce MCP open source (read-only): release and ops guide - npm scope, registry, Glama, and how we ship updates without write tools
Articles (off-site)
Field notes published on DEV (not duplicates of wppoland.com pages):