Overview
What is WooCommerce MCP Server?
An MCP (Model Context Protocol) server that provides full integration with WooCommerce stores via the WordPress REST API. It allows AI assistants to manage products, orders, customers, shipping, taxes, coupons, and store configuration using a comprehensive set of tools.
How to use WooCommerce MCP Server?
Clone the repository, install dependencies with pip install -r requirements.txt, create a .env file with your WordPress site URL and WooCommerce REST API keys, then initialize and run the server using initialize() and mcp.run() in a Python script. Alternatively, deploy directly to Railway by connecting your GitHub repo and setting the required environment variables.
Key features of WooCommerce MCP Server
- Full coverage of WooCommerce REST API (products, orders, customers, shipping, taxes, coupons, reports, settings)
- WordPress content management (posts and meta data)
- Batch operations for product variations, tax rates, and coupons
- Deployable on Railway with automatic SSL, monitoring, and scaling
- Environment-based configuration for all credentials
- Supports both WooCommerce and WordPress authentication methods
Use cases of WooCommerce MCP Server
- Manage products, inventory, categories, tags, and attributes via AI prompts
- Create and update orders, process refunds, and manage order notes
- Configure shipping zones, methods, and tax classes/rates
- Generate sales, product, customer, and stock reports
- Apply bulk discounts using coupon creation and batch update
FAQ from WooCommerce MCP Server
What do I need to use the server?
A WordPress site with the WooCommerce plugin installed, WooCommerce REST API consumer key and secret (created under WooCommerce โ Settings โ Advanced โ REST API), and optionally WordPress username/password for WordPress-specific API methods.
Can I run this server locally or only in the cloud?
You can run it locally after cloning the repository and installing dependencies. The README also provides step-by-step deployment instructions for Railway, which offers automatic SSL, logging, and scaling.
What API methods are included?
The server includes methods for products, categories, tags, attributes, variations, orders (notes and refunds), customers, shipping zones and methods, tax classes and rates, coupons, payment gateways, reports, settings, system status, and data endpoints (countries, states, currencies). A full table is provided in the README.
How do I authenticate with WooCommerce and WordPress?
For WooCommerce, you must provide WOOCOMMERCE_CONSUMER_KEY and WOOCOMMERCE_CONSUMER_SECRET. For WordPress-specific methods, additionally set WORDPRESS_USERNAME and WORDPRESS_PASSWORD in your environment variables or pass them directly to function calls.
What are the system requirements?
Python 3.9 or higher, a WordPress site with WooCommerce installed, and the WooCommerce REST API must be enabled. The server uses Python's async/await and the WooCommerce REST API.
