Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
WooCommerce MCP
Überblick
Beschreibung vom Entwickler (englisches Original)
Manage WooCommerce stores: products, orders, customers, coupons, webhooks, and analytics.
Die drei Säulen von PopNx MCP
Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.
- Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
- Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
- NutzungiNoch nicht gemessen★ –
Was du damit machen kannst
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
- Verbindung: Läuft auf deinem Computer
- Transport: stdio
- Kategorie: Onlineshops & Zahlungen
- Das musst du eintragen: WOOCOMMERCE_URL, WOOCOMMERCE_CONSUMER_KEY, WOOCOMMERCE_CONSUMER_SECRET
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Bevor du installierst
- Basischecks: 1 von 1 bestanden
- Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
- Das trägst du selbst ein:
WOOCOMMERCE_URL,WOOCOMMERCE_CONSUMER_KEY,WOOCOMMERCE_CONSUMER_SECRET,WOOCOMMERCE_READ_ONLY,WOOCOMMERCE_REDACT_PII,WOOCOMMERCE_TOOLS_DENY
Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.
Du brauchst
- npmNode.js installiert (für den Befehl npx)
Welche App nutzt du?
Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.
Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein
{
"mcpServers": {
"woocommerce": {
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "your-value",
"WOOCOMMERCE_CONSUMER_KEY": "your-value",
"WOOCOMMERCE_CONSUMER_SECRET": "your-value",
"WOOCOMMERCE_READ_ONLY": "your-value",
"WOOCOMMERCE_REDACT_PII": "your-value",
"WOOCOMMERCE_TOOLS_DENY": "your-value"
}
}
}
}Führe das in deinem Terminal aus
claude mcp add woocommerce --env WOOCOMMERCE_URL=your-value --env WOOCOMMERCE_CONSUMER_KEY=your-value --env WOOCOMMERCE_CONSUMER_SECRET=your-value --env WOOCOMMERCE_READ_ONLY=your-value --env WOOCOMMERCE_REDACT_PII=your-value --env WOOCOMMERCE_TOOLS_DENY=your-value -- npx -y @sadrmanesh/woocommerce-mcpTrag die leeren Werte ein, bevor du ihn startest.
Oder kopier die Einstellungen selbst
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"mcpServers": {
"woocommerce": {
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "your-value",
"WOOCOMMERCE_CONSUMER_KEY": "your-value",
"WOOCOMMERCE_CONSUMER_SECRET": "your-value",
"WOOCOMMERCE_READ_ONLY": "your-value",
"WOOCOMMERCE_REDACT_PII": "your-value",
"WOOCOMMERCE_TOOLS_DENY": "your-value"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Oder kopier die Einstellungen selbst
In .vscode/mcp.json in deinem Projekt einfügen
{
"servers": {
"woocommerce": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sadrmanesh/woocommerce-mcp"
],
"env": {
"WOOCOMMERCE_URL": "your-value",
"WOOCOMMERCE_CONSUMER_KEY": "your-value",
"WOOCOMMERCE_CONSUMER_SECRET": "your-value",
"WOOCOMMERCE_READ_ONLY": "your-value",
"WOOCOMMERCE_REDACT_PII": "your-value",
"WOOCOMMERCE_TOOLS_DENY": "your-value"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.
Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.
Werte, die du selbst einträgst
- Store origin, such as https://store.example.com
- WooCommerce REST API consumer key (ck_...)
- WooCommerce REST API consumer secret (cs_...)
WOOCOMMERCE_READ_ONLYenvRefuse every write tool. Set to false to allow writesWOOCOMMERCE_REDACT_PIIenvMask customer names, emails, phones, and addresses in resultsWOOCOMMERCE_TOOLS_DENYenvComma-separated tool names or patterns to hide, such as delete_*
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto sadrmanesh bestätigt, dem das Repo gehört
- … Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
- … Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Im Vergleich mit anderen in Onlineshops & Zahlungeni
- Mehr Sterne als 0 % der anderen 1755 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 80 % der anderen 1755 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 1755 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist WooCommerce MCP sicher?
Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: WOOCOMMERCE_URL, WOOCOMMERCE_CONSUMER_KEY, WOOCOMMERCE_CONSUMER_SECRET
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.6.0) kam vor 7 Tagen in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Alternativen
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
woocommerce-mcp
A Model Context Protocol server for running one or more WooCommerce stores through the WooCommerce REST API. MCP clients can browse the catalog, work through and fulfill orders, issue refunds, adjust prices and stock in bulk, run promotions, segment customers, react to webhooks, and read sales analytics. Every change is previewed before it is applied and can be written to an audit log.
It runs locally over stdio, or as a remote service over streamable HTTP with bearer-token or OAuth 2.0 authentication, and ships as a Docker image on the GitHub Container Registry.
Documentation: https://sadrmanesh.github.io/woocommerce-mcp/ · Tool explorer: Hugging Face Space
Read more: Safe write tools for agents: preview, confirm, audit, and stale previews in a WooCommerce MCP server on Dev.to · Preview, confirm, audit on LinkedIn · Update: A week of reader feedback: what changed in my four AI-for-commerce tools on Dev.to · What reader feedback taught me about building production-safe AI tooling for commerce on LinkedIn
Listed on the official MCP Registry as io.github.sadrmanesh/woocommerce-mcp, on Glama, and on mcpservers.org.
Contents
- Highlights
- Quick start
- Connect an MCP client
- Tools, resources, and prompts
- Safe writes
- Configuration
- Deployment
- Development
- Documentation
Highlights
- Multi-store. Configure any number of stores and pick one per call with
store. Each store has its own credentials and its own read-only switch. - Safe by default. Stores are read-only until you allow writes. Write tools then return a preview of the exact REST request and apply it only when called again with
confirm: true. A confirm is refused if the arguments or the store data the change was computed from changed since the preview.dryRun: truealways previews. - Signed approvals (optional). Set
WOOCOMMERCE_APPROVAL_SECRETand a confirm also needs a short-lived, single-use token signed for that exact preview by someone outside the agent's reach, for example withwoocommerce-mcp approve. The agent cannot approve its own writes. - Audit log. One JSON line per write attempt: applied, previewed, refused, or failed, with the tool, store, arguments, caller, and a preview id that links each confirmed write to its preview.
- Refunds and bulk operations. Partial or line-item refunds, batch updates of up to 100 products, and percentage or fixed price adjustments.
- Analytics. Sales by day, week, or month with refunds, average order value, top products, and payment methods, plus a low-stock report that covers variations.
- Promotions and customers. Coupon performance, scheduled sales, and customer segments such as VIP, repeat, and at risk.
- Fulfillment. Order notes, shipment tracking, and one-step fulfillment that emails the customer.
- Webhooks. Manage store webhooks and receive signed deliveries, readable as MCP resources.
- Shipping and taxes. Read shipping zones, methods, tax rates, and tax classes.
- Privacy and control. Optional PII redaction, and tool allow and deny lists per deployment or per store.
- Gentle on the store. Per-store rate limiting, retries with backoff and jitter, and an optional read cache.
- Remote ready. Streamable HTTP with static bearer tokens (full or read-only) or RFC 7662 token introspection, RFC 9728 protected resource metadata, Host and Origin checks, and a health endpoint.
- MCP resources and prompts. Read products and orders by URI, and start common workflows such as a sales briefing or a restock plan.
- Observability. Optional OpenTelemetry traces for every tool call and WooCommerce request.
- Well tested. Strict TypeScript, Zod validation on every input, and tests against a mocked WooCommerce API.
Quick start
Node.js 20 or newer is required.
npm install -g @sadrmanesh/woocommerce-mcp
Or run the Docker image from the GitHub Container Registry (linux/amd64 and linux/arm64, tags X.Y.Z, X.Y, and latest). The same image is on Docker Hub as sadrmanesh/woocommerce-mcp:
docker run --rm -i -e MCP_TRANSPORT=stdio \
-e WOOCOMMERCE_URL -e WOOCOMMERCE_CONSUMER_KEY -e WOOCOMMERCE_CONSUMER_SECRET \ ghcr.io/sadrmanesh/woocommerce-mcp:0.6.0
The npm package is also on GitHub Packages; see Install options for the .npmrc setup. npmjs.com remains the main registry.
Or from a checkout:
git clone https://github.com/sadrmanesh/woocommerce-mcp.git
cd woocommerce-mcp npm install npm run build cp .env.example .env
Create a REST API key under WooCommerce > Settings > Advanced > REST API. Use a Read key while the store is read-only, and a Read/Write key only when you enable writes. WordPress permalinks must not be set to "Plain", or /wp-json/ will not resolve.
WOOCOMMERCE_URL=https://store.example.com \
WOOCOMMERCE_CONSUMER_KEY=ck_... \ WOOCOMMERCE_CONSUMER_SECRET=cs_... \ woocommerce-mcp
The process then serves MCP on stdin and stdout. Logs go to stderr. npm start in a checkout loads .env from the working directory without overriding variables that are already set.
Connect an MCP client
Most hosts accept an mcpServers map like the ones below. Keep secrets in env, never in args. Docker, Smithery, and MCP Registry installs are in docs/install.md.
stdio
{
"mcpServers": { "woocommerce": { "command": "npx", "args": ["-y", "@sadrmanesh/woocommerce-mcp"], "env": { "WOOCOMMERCE_URL": "https://store.example.com", "WOOCOMMERCE_CONSUMER_KEY": "ck_your_consumer_key", "WOOCOMMERCE_CONSUMER_SECRET": "cs_your_consumer_secret" } } } }
From a checkout, use "command": "node" and "args": ["/absolute/path/to/woocommerce-mcp/dist/index.js"].
Streamable HTTP
MCP_TRANSPORT=http MCP_HTTP_AUTH_TOKENS="$(openssl rand -base64 32)" woocommerce-mcp
{
"mcpServers": { "woocommerce": { "type": "http", "url": "https://mcp.example.com/mcp", "headers": { "Authorization": "Bearer " } } } }
Without authentication the HTTP endpoint only binds to loopback. See docs/security.md for tokens, scopes, and OAuth introspection.
Tools, resources, and prompts
Every tool except woocommerce_list_stores accepts an optional store id. Without it, the default store is used.
To browse every tool with its full input schema and build tools/call requests in the browser, open the tool explorer on Hugging Face.
| Area | Read tools | Write tools |
|---|---|---|
| Stores | list_stores | |
| Products | list_products, search_products, get_product | create_product, update_product, bulk_update_products, bulk_adjust_prices |
| Orders | list_orders, get_order, list_order_notes | update_order_status, add_order_note, delete_order_note |
| Fulfillment | get_order_tracking | fulfill_order |
| Refunds | list_refunds, get_refund | create_refund |
| Customers | list_customers, get_customer, customer_orders, customer_segments | update_customer |
| Stock | get_stock, low_stock_report | update_stock |
| Coupons and sales | list_coupons, get_coupon, coupon_performance | create_coupon, update_coupon, delete_coupon, schedule_sale, end_sale |
| Webhooks | list_webhooks, get_webhook, list_webhook_events | create_webhook, update_webhook, delete_webhook |
| Shipping and taxes | list_shipping_zones, list_shipping_methods, list_tax_rates, list_tax_classes | |
| Analytics | get_store_summary, sales_analytics |
Every name starts with woocommerce_, for example woocommerce_customer_segments. That makes 47 tools: 28 reads and 19 writes.
Resources
| URI | Content |
|---|---|
woocommerce://stores | Configured stores |
woocommerce://stores/{store}/products/{id} | One product |
woocommerce://stores/{store}/orders/{id} | One order |
woocommerce://stores/{store}/events | Recent webhook deliveries |
woocommerce://stores/{store}/events/{id} | One webhook delivery with its payload |
Prompts: sales_briefing, restock_plan, order_triage, and price_change_review.
Full argument and response details are in docs/tools.md.
Safe writes
- Read-only stores. A store accepts writes only when
WOOCOMMERCE_READ_ONLY=false(single store) or"readOnly": false(store list). Otherwise write tools fail withread_onlybefore contacting the store. - Confirmation. With
WOOCOMMERCE_REQUIRE_CONFIRMATION=true(the default), the first call returns the planned request and changes nothing:
{
"status": "confirmation_required", "store": "default", "previewId": "pv_4f1c9a2e7b3d0856", "message": "The change was NOT applied. ...", "request": { "method": "PUT", "path": "orders/1015",
Nur der Anfang wird gezeigt; den Rest findest du im Repo