gitwtfhub

wtf is woocommerce-mcp?

wppoland/woocommerce-mcp — explained in plain English

Analysis updated 2026-05-18

2JavaScriptAudience · developerLicense

TL;DR

A read-only MCP server that lets Claude or another AI agent query a live WooCommerce store's products, orders, sales, and blog posts.

Mindmap

mindmap
  root((woocommerce-mcp))
    What it does
      Read-only store access
      MCP server
    Tech stack
      Node.js
      WooCommerce REST API
      MCP protocol
    Use cases
      Sales reporting
      Product lookup
    Audience
      Developers
      Store owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Let an AI assistant answer questions about your store's recent orders or sales totals.

REASON 2

Give Claude Desktop read access to a WooCommerce store's product catalog.

REASON 3

Search a WordPress site's blog posts through an AI agent without exposing write access.

What's in the stack?

JavaScriptNode.jsMCPWooCommerce REST API

How it stacks up

wppoland/woocommerce-mcp3imed-jaberi/cryptography-si-isamm3imed-jaberi/koa-isomorphic-router
Stars222
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-09-252021-02-06
MaintenanceDormantDormant
Setup difficultyeasyeasy
Complexity1/52/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

Wtf does this do

woocommerce-mcp is a small server that lets an AI assistant like Claude look up information from a live WordPress and WooCommerce online store. It follows a standard called the Model Context Protocol, or MCP, which is a way for AI tools to connect to outside data sources in a consistent format. The server is strictly read-only. It cannot create, edit, or delete anything in the store, it can only answer questions by reading data through the store's existing REST APIs. It offers five tools an AI assistant can call: listing or searching products, getting full details on one product, listing recent orders with an optional status filter, generating a sales report for a chosen time period, and searching published blog posts. The blog post search works on any public WordPress site without needing credentials, while the other tools need WooCommerce API keys with read-only permission. Setting it up involves installing the package from npm or building it from source, then providing three pieces of configuration: the store's web address and a WooCommerce consumer key and secret, which are generated from the store's own admin settings and should be limited to read access. Once configured inside an MCP client such as Claude Desktop or Claude Code, a person can ask natural questions like what last month's sales were or which recent orders are on hold, and the assistant will fetch the real answer from the store. The project requires Node.js 18 or newer, keeps its logs separate from its main communication channel so nothing gets corrupted, and never echoes back any credentials in error messages. It is built and maintained by WPPoland and released under the MIT license.

Yoink these prompts

Prompt 1
Help me configure woocommerce-mcp with my WooCommerce consumer key and secret.
Prompt 2
Explain what each of the five tools in this MCP server does.
Prompt 3
Show me how to add this server to my claude_desktop_config.json.
Prompt 4
How do I generate a read-only WooCommerce REST API key for this?

Frequently asked questions

wtf is woocommerce-mcp?

A read-only MCP server that lets Claude or another AI agent query a live WooCommerce store's products, orders, sales, and blog posts.

What language is woocommerce-mcp written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, MCP.

Who is woocommerce-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.