Woocommerce MCP

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.