woocommerce-mcp
This is a read-only MCP server for WordPress + WooCommerce that lets you query store data and blog content via the official REST APIs. It never creates, modifies, or deletes any data.
list_products: Search and browse WooCommerce products by name/SKU or filter by status (draft, pending, private, publish). Returns product ID, name, SKU, price, stock status, and permalink. Supports pagination.get_product: Retrieve full details for a single WooCommerce product by its ID.list_orders: View recent WooCommerce orders (newest first), optionally filtered by status (pending, processing, on-hold, completed, cancelled, refunded, failed). Supports pagination.sales_report: Get WooCommerce sales totals — gross sales, order count, and items sold — for a given period (week, month, last_month, or year).search_posts: Search published WordPress blog posts via the public WordPress REST API (no WooCommerce credentials required). Supports pagination.
Provides read-only access to WooCommerce store data: list/search products, get product details, list orders, and retrieve sales reports.
Allows searching published blog posts via the public WordPress REST API. No authentication required.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@woocommerce-mcpWhat were last month's sales totals?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 — senior WordPress & WooCommerce engineering. 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 / search products (name, sku, price, stock, permalink) | yes |
| Full details for one product by id | yes |
| Recent orders, newest first, optional status filter | yes |
| Sales totals for a period (week / month / last_month / year) | yes |
| Search published blog posts (public WP REST API) | no |
Everything is read-only. The server never creates, edits, or deletes anything in the store.
Related MCP server: WooCommerce MCP Server by CData
Install & build
git clone https://github.com/wppoland/woocommerce-mcp.git
cd woocommerce-mcp
npm install
npm run buildConfigure
Set three environment variables:
Var | Required | Example |
| yes |
|
| for |
|
| for |
|
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):
{
"mcpServers": {
"woocommerce": {
"command": "node",
"args": ["/absolute/path/to/woocommerce-mcp/dist/index.js"],
"env": {
"WP_URL": "https://shop.example.com",
"WC_CONSUMER_KEY": "ck_xxx",
"WC_CONSUMER_SECRET": "cs_xxx"
}
}
}
}Then ask things like "What were last month's WooCommerce sales?" or "List the 5 most recent orders that are on hold."
Verify
npm run check # builds, then asserts all five tools register (no network/credentials needed)Notes
Node 18+ (uses the built-in
fetch).Logs go to stderr so they never corrupt the stdio MCP protocol on stdout.
API errors are surfaced with the store's message; credentials are never echoed.
License
MIT © WPPoland
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wppoland/woocommerce-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server