GitHub - wppoland/woocommerce-mcp: Read-only Model Context Protocol (MCP) server for WordPress + WooCommerce — give Claude and other AI agents access to products, orders, sales reports and posts over the REST API. By wppoland.com · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
wppoland
woocommerce-mcp
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
master
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>4 Commits<br>4 Commits
src
src
test
test
.dockerignore
.dockerignore
.gitignore
.gitignore
Dockerfile
Dockerfile
LICENSE
LICENSE
README.md
README.md
package-lock.json
package-lock.json
package.json
package.json
tsconfig.json
tsconfig.json
View all files
Repository files navigation
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<br>What it does<br>Needs WooCommerce keys
list_products<br>List / search products (name, sku, price, stock, permalink)<br>yes
get_product<br>Full details for one product by id<br>yes
list_orders<br>Recent orders, newest first, optional status filter<br>yes
sales_report<br>Sales totals for a period (week / month / last_month / year)<br>yes
search_posts<br>Search published blog posts (public WP REST API)<br>no
Everything is read-only . The server never creates, edits, or deletes anything in the store.
Install & build
git clone https://github.com/wppoland/woocommerce-mcp.git<br>cd woocommerce-mcp<br>npm install<br>npm run build
Configure
Set three environment variables:
Var<br>Required<br>Example
WP_URL<br>yes<br>https://shop.example.com
WC_CONSUMER_KEY<br>for wc_* tools<br>ck_xxx
WC_CONSUMER_SECRET<br>for wc_* tools<br>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):
"mcpServers": {<br>"woocommerce": {<br>"command": "node",<br>"args": ["/absolute/path/to/woocommerce-mcp/dist/index.js"],<br>"env": {<br>"WP_URL": "https://shop.example.com",<br>"WC_CONSUMER_KEY": "ck_xxx",<br>"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
About
Read-only Model Context Protocol (MCP) server for WordPress + WooCommerce — give Claude and other AI agents access to products, orders, sales reports and posts over the REST API. By wppoland.com
wppoland.com/en/services/mcp-server-development/
Topics
wordpress
ecommerce
typescript
rest-api
mcp
woocommerce
ai-agents
claude
anthropic
llm-tools
model-context-protocol
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
No releases published
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
JavaScript<br>93.7%
Dockerfile<br>6.3%
You can’t perform that action at this...