# wppoland/woocommerce-mcp [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/wppoland/woocommerce-mcp  
**GitHub Stars:** 2  
**npm Downloads (last month):** 231  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/wppoland-woocommerce-mcp

## Description
Read-only MCP server for WordPress + WooCommerce. Five tools over the existing WP/WooCommerce REST APIs: list/search products, product details, recent orders, sales reports (week/month/lastmonth/year), and public blog-post search. No writes, no store-side plugin to install. Built by WPPoland. Install: git clone + npm run build.

## Tools
Capabilities this server exposes over MCP:

- **list_products** — List / search products (name, sku, price, stock, permalink)
- **get_product** — Full details for one product by id
- **list_orders** — Recent orders, newest first, optional status filter
- **sales_report** — Sales totals for a period (week / month / last_month / year)
- **search_posts** — Search published blog posts (public WP REST API)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "woocommerce-mcp": {
    "command": "npx",
    "args": ["-y","@wppoland/woocommerce-mcp"],
    "env": {
      "WP_URL": "",
      "WC_CONSUMER_KEY": "",
      "WC_CONSUMER_SECRET": ""
    }
  }
}
```

**Requires environment variables:** `WP_URL`, `WC_CONSUMER_KEY`, `WC_CONSUMER_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What wppoland/woocommerce-mcp MCP server does

The wppoland/woocommerce-mcp MCP server connects an MCP client to an existing WordPress and WooCommerce site. It provides five read-only tools for inspecting store and publishing data:

- `list_products` lists or searches products and returns fields such as name, SKU, price, stock, and permalink.
- `get_product` retrieves full details for a product by its ID.
- `list_orders` returns recent orders in newest-first order and can filter by status.
- `sales_report` returns sales totals for the week, month, previous month, or year.
- `search_posts` searches published WordPress blog posts through the public REST API.

The server does not create, update, or delete products, orders, posts, or other store records. It also does not require a plugin to be installed on the WordPress site.

## How it works

The server communicates with the site’s existing REST endpoints. WooCommerce tools authenticate with a consumer key and consumer secret, while blog-post search can query any public WordPress site without WooCommerce credentials. Credentials are sent to the configured store over HTTPS as REST query authentication, so the store should use HTTPS and the keys should have read-only permission.

MCP clients invoke the tools and receive the corresponding API data. API errors are passed through with the store’s message, and credentials are not echoed in logs. Logs are written to stderr so they do not interfere with the stdio MCP protocol on stdout.

## Setup and configuration

Install the wppoland/woocommerce-mcp MCP server from npm or build it from the Git repository. The project requires Node.js 18 or newer because it uses the built-in `fetch` implementation. A source installation uses `npm install` followed by `npm run build`; the resulting entry point is `dist/index.js`.

Set these environment variables before starting the server:

- `WP_URL`: the WordPress site URL.
- `WC_CONSUMER_KEY`: a WooCommerce REST API consumer key for store tools.
- `WC_CONSUMER_SECRET`: the matching WooCommerce REST API consumer secret.

Create the WooCommerce credentials under WooCommerce settings, Advanced, REST API, and grant Read permission. `search_posts` remains available without the two WooCommerce variables when the WordPress site is public.

## Tools and capabilities

The wppoland/woocommerce-mcp MCP server is suitable for conversational store lookups such as checking product availability, reviewing recent orders, or asking for last month’s sales total. Product search supports name and related product fields, while order retrieval supports an optional status filter. Sales periods are limited to the documented week, month, last month, and year options.

A typical Claude Desktop configuration runs the built JavaScript file with Node and supplies the three environment variables in the MCP server definition. The README also identifies Claude Code as a supported usage context.

## Limitations and notes

This is a read-only interface. It cannot modify catalog data, process orders, change order status, publish posts, or perform other write operations. WooCommerce keys are required for the product, order, and sales tools, but not for public post search. The server depends on the target site’s WordPress and WooCommerce REST APIs and does not provide a separate store-side plugin.

The repository includes a `check` script that builds the project and verifies that all five tools register without requiring network access or credentials. The project is released under the MIT license.

_Full upstream README: https://allmcps.com/mcp/wppoland-woocommerce-mcp/readme_