wp-woo-mcp
Provides tools for interacting with a WooCommerce store through its REST API, including listing and retrieving products and orders, creating draft products, updating product prices, sale prices, stock and descriptions, updating order status with private notes, and retrieving sales reports.
Provides tools for interacting with a WordPress site through its REST API, including retrieving site information, listing and getting posts and pages, and creating, updating, or trashing posts with draft-only creation and no permanent deletes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wp-woo-mcp show me this month's sales report"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
wp-woo-mcp
An MCP server for WordPress and WooCommerce. It lets AI assistants and agents read and manage a site through the official REST APIs, with safety defaults built in.
Read-only by default. Writes need an explicit switch.
Drafts, not publishes. New posts and products are created as drafts.
No permanent deletes. Posts go to the trash and can be recovered.
Audit log. Every write is logged as a JSON line on stderr, with before and after values for prices and order status.
Least privilege. Uses WordPress application passwords and WooCommerce API keys, so the server can only do what those credentials allow.
Tools
Tool | Type | What it does |
| read | Shows what is configured and whether write mode is on |
| read | List posts, filter by status or search |
| read | Get one post with content |
| read | List pages |
| write | Create a draft post |
| write | Edit title, content, excerpt (cannot publish) |
| write | Move a post to the trash |
| read | List products, filter by search, SKU, stock |
| read | Get one product |
| write | Create a draft simple product |
| write | Update price, sale price, stock, description |
| read | List orders, newest first |
| read | Get one order |
| write | Change order status, optional private note |
| read | Sales totals for a period |
Related MCP server: WordPress MCP Server
Setup
1. Create credentials
WordPress: in wp-admin go to Users, Profile, Application Passwords, and create one. Use a user with only the role you want the agent to have (for example Editor).
WooCommerce: go to WooCommerce, Settings, Advanced, REST API, and add a key. Choose Read permission unless you plan to enable write mode. Your site must use HTTPS.
2. Add it to your MCP client
{
"mcpServers": {
"wordpress": {
"command": "npx",
"args": ["-y", "wp-woo-mcp"],
"env": {
"WP_URL": "https://your-site.com",
"WP_USER": "your-username",
"WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
"WC_KEY": "ck_...",
"WC_SECRET": "cs_...",
"WP_MCP_MODE": "read"
}
}
}
}To run from source instead, use "command": "node" and "args": ["/path/to/wp-woo-mcp/dist/index.js"].
Environment variables
Variable | Required | Description |
| yes | Site URL, no trailing slash |
| for WordPress tools | WordPress username |
| for WordPress tools | Application password |
| for WooCommerce tools | Consumer key |
| for WooCommerce tools | Consumer secret |
| no |
|
You can configure only WordPress or only WooCommerce. Tools for the unconfigured side return a clear error.
Development
npm install
npm run build
WP_URL=https://your-site.com WP_USER=... WP_APP_PASSWORD=... node dist/index.jsTo inspect it interactively: npx @modelcontextprotocol/inspector node dist/index.js
Security notes
Start in
readmode and a staging site. Switch towriteonly when you trust the workflow.Use dedicated credentials for the agent, not an administrator account.
Treat page and product content as untrusted input. A post on your site could contain text written to manipulate an AI that reads it, so keep write mode off for agents that process content from outside sources.
Rotate keys if you stop using the server.
Roadmap
Media uploads
Categories, tags and custom post types
Product variations
Optional approval step for writes
Hosted version with team permissions
License
MIT
Available Tools
15 toolswc_create_productB
Create a simple WooCommerce product as a draft. Requires write mode.
Inputs: name (required), regular_price (required), sku, description, +1 more.
wc_get_orderC
Get one WooCommerce order.
Inputs: id (required).
wc_get_productC
Get one WooCommerce product with its description.
Inputs: id (required).
wc_list_ordersB
List WooCommerce orders, newest first. Filter by status.
Inputs: page, status, per_page.
wc_list_productsC
List WooCommerce products. Filter by search text, SKU or stock status.
Inputs: sku, page, search, status, +2 more.
wc_sales_reportC
Sales totals for a period. Uses WooCommerce's reports endpoint.
Inputs: period.
wc_update_order_statusA
Change a WooCommerce order's status (for example processing to completed). Cannot refund. Requires write mode.
Inputs: id (required), status (required), note.
wc_update_productB
Update a WooCommerce product's price, sale price, stock or description. Cannot change publish status. Requires write mode.
Inputs: id (required), sale_price, description, regular_price, +1 more.
wp_create_postB
Create a WordPress post. Always created as a draft unless the owner has allowed otherwise. Requires write mode.
Inputs: title (required), content (required), excerpt.
wp_get_postC
Get one WordPress post, including its content.
Inputs: id (required).
wp_list_pagesC
List WordPress pages.
Inputs: page, search, status, per_page.
wp_list_postsB
List WordPress posts. Optionally filter by status or search text.
Inputs: page, search, status, per_page.
wp_site_infoA
Show which capabilities are configured (WordPress, WooCommerce) and whether write mode is on.
Inputs: no named parameters.
wp_trash_postA
Move a WordPress post to the trash (recoverable). Never permanently deletes. Requires write mode.
Inputs: id (required).
wp_update_postA
Update a WordPress post's title, content or excerpt. Cannot publish; publishing is done by a human in wp-admin. Requires write mode.
Inputs: id (required), title, content, excerpt.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
The wp_/wc_ prefixes plus action names cleanly separate WordPress content tools from WooCommerce commerce tools, and no two tools do the same thing. The only soft spot is posts vs. pages: wp_get_post/wp_update_post have no page equivalents, so an agent must infer that wp_list_pages is read-only and not a candidate for page retrieval or edits.
Nearly all tools follow a strict prefix + verb_noun pattern (wp_list_posts, wp_get_post, wc_update_order_status), which is very predictable. wp_site_info breaks the pattern as the one noun-only tool, a minor deviation.
15 tools is well within a healthy range and each one maps to a distinct resource-and-action pair across two domains. Nothing feels padded or redundant; the read/write split per resource is proportionate.
Posts have full read/create/update/trash coverage and products and orders have solid read/update surfaces, but pages are list-only with no get, create or update, and there is no product deletion, no customer tools. Refunds and publishing are explicitly out of scope, which is a deliberate but real dead end.
Maintenance
Related MCP Connectors
Manage your WordPress site from your AI assistant: posts, pages, media, comments and WooCommerce.
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Manage a WordPress site from your AI assistant: read, search, propose edits, Search Console data.
Manage your WordPress site from ChatGPT or Claude: posts, WooCommerce, SEO, images and upkeep.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with WordPress sites through REST APIs, allowing programmatic management of posts, users, comments, categories, and tags with secure authentication.2950MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage WordPress sites through natural conversation, supporting post creation, content updates, site queries, and draft-to-publish workflows via the WordPress REST API.9MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to read and edit WordPress sites over the REST API, including Divi 4, Divi 5, and Gutenberg content, with safety features like round-trip verification, draft-based editing, and dry-run previews.45MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage WordPress posts, pages, media, taxonomies, comments, users, settings, and custom fields through the WordPress REST API. Supports secure authentication, OAuth deployment, search, and safe write controls.MIT