MCP WooCommerce Server

You run an MCP server that exposes WooCommerce actions through a consistent MCP interface. It lets you search products, list products, create orders, and fetch orders securely using an API key or in development without authentication. This guide shows how to use the server, install it locally, and understand the security and configuration details so you can connect your MCP clients with confidence.

How to use

Connect with an MCP client and you can perform common WooCommerce operations through concise tool calls. Use a valid API key in production to protect your data. The server supports product search, product listing with pagination, order creation, and order retrieval and listing, all through a uniform MCP interface.

How to install

Prerequisites: You need Python and Docker to choose your preferred setup. Have a working internet connection and a local development environment.

# Install dependencies and start using Python
pip install -r requirements.txt
python -m src.server

# Or run with Docker Compose
docker-compose up --build

Additional setup and configuration

Configure WooCommerce credentials and the MCP API key to enable secure access.

WOO_URL=https://yourstore.com
WOO_CONSUMER_KEY=your_consumer_key
WOO_CONSUMER_SECRET=your_consumer_secret
MCP_API_KEY=your_secure_api_key_here

Security and authentication

The server uses API Key authentication to protect access. When an API key is configured, all requests must include the key in the Authorization header.

Running locally

You can start the server either via Python or Docker Compose. Use the approach that fits your workflow.

docker-compose up --build

pip install -r requirements.txt
python -m src.server

Notes on architecture and endpoints

The server follows a modular architecture and exposes the following MCP tools to perform WooCommerce actions: search_products, list_products, create_order, get_order, list_orders.

Environment and tooling

Key environment variables for running the server locally include the WooCommerce credentials and the MCP API key.

Troubleshooting tips

Verify that the WooCommerce credentials are correct, ensure the API key is set for production use, and confirm the server URL and port are reachable from your MCP client.

Available tools

search_products

Search for products by name or SKU and retrieve matching results with pagination options.

list_products

List all products with pagination support to handle large catalogs.

create_order

Create a new order with customer details and line items to WooCommerce.

get_order

Retrieve a specific order by its ID to inspect status and details.

list_orders

List orders with optional filters such as customer, status, and pagination.