woocommerce

This WooCommerce MCP Server provides a bridge between Model Context Protocol clients and a WooCommerce store via the WordPress REST API. It exposes a wide range of methods spanning WordPress content management and WooCommerce operations, including creating and retrieving posts, managing products, orders, customers, and metadata, as well as handling categories, tags, attributes, variations, and shipping configurations. Clients interact with the server over JSON-RPC 2.0, issuing method calls such as get_products, create_order, get_customer, create_post, and many others to perform store automation and data retrieval tasks. The server is designed to run on Windows, macOS, and Linux, making it accessible across common development and production environments. To use it, configure the MCP settings with the required environment credentials, start the server, and then call the supported methods with appropriate parameters to manage your WooCommerce store and WordPress content.

Prerequisites:

• Node.js (recommended LTS) installed on your system
• Internet access to install npm dependencies

Steps:

1. Clone the repository: git clone https://github.com/techspawn/woocommerce-mcp-server.git cd woocommerce-mcp-server

2. Install dependencies: npm install

3. Build the project: npm run build

4. Run or integrate with MCP:

   • Ensure your MCP configuration points to the built index.js (path/to/build/index.js) as shown in the example configuration.
   • Start the MCP server via your preferred MCP runner or directly via node if testing locally: node path/to/build/index.js

5. Test connectivity:

   • Use an MCP client to send JSON-RPC requests to the running server using the configured environment variables for WordPress and WooCommerce credentials.

Notes and tips:

• The server relies on WooCommerce REST API credentials (consumer key/secret) and WordPress credentials for certain WordPress methods. Keep these credentials secure and rotate them as needed.
• Environment variables can be provided either in the MCP configuration or per-request if supported by your MCP client; the README demonstrates environment-based credentials.
• Ensure WordPress REST API access is enabled on your site and that WooCommerce is configured with REST API keys.
• For WordPress content methods (e.g., create_post, get_posts), a WordPress username and password are required for basic authentication.
• If you encounter authentication errors, verify URL formatting, API keys, user permissions, and that your site allows external REST access.
• The API supports a broad set of methods across WordPress content management, WooCommerce product operations, orders, customers, and shipping configurations. Review the full method list in the server documentation to leverage the complete capabilities.