woocommerce

This MCP server provides a bridge between a WooCommerce store and Claude/other AI assistants via the Model Context Protocol. It exposes tools to fetch recent orders and to retrieve detailed information about a specific order by ID. You can connect to the server using a standard MCP client, and then invoke the available tools to interact with your store data. The server reads WooCommerce credentials from environment variables (or from defaults in code) and uses them to authenticate against the WooCommerce REST API, returning structured results suitable for AI-assisted workflows.

Prerequisites:

• Node.js v18 or higher
• Access to a WooCommerce store with REST API credentials (consumer key and consumer secret)

Install and run locally:

1. Clone the repository

git clone https://github.com/techspawn/woocommerce-mcp-server.git
cd woocommerce-mcp-server

2. Install dependencies

npm install

3. Configure credentials (choose one):

• Option A: Run with environment variables

WOOCOMMERCE_URL=https://your-store.com \
WOOCOMMERCE_CONSUMER_KEY=your-consumer-key \
WOOCOMMERCE_CONSUMER_SECRET=your-consumer-secret \
node index.js

• Option B: Edit default values in index.js

const woocommerceConfig = {
  url: process.env.WOOCOMMERCE_URL || 'https://your-store.com',
  consumerKey: process.env.WOOCOMMERCE_CONSUMER_KEY || 'your-consumer-key',
  consumerSecret: process.env.WOOCOMMERCE_CONSUMER_SECRET || 'your-consumer-secret',
  version: 'wc/v3'
};

4. Start the server

node index.js

5. (Optional) Use the provided npm script if present in package.json

npm start

Tips:

• Ensure your WooCommerce store URL uses HTTPS and that the REST API keys have the necessary permissions.
• If you encounter authentication errors, double-check the consumer key/secret and the store URL.
• When integrating with Claude for Desktop, ensure your Claude config points to the correct node command and to the absolute path of index.js if using a custom setup.
• The server exposes two tools: getRecentOrders and getOrderById. You can filter by status and limit results for getRecentOrders, and fetch full order details for getOrderById.
• For local testing, you can run the server directly with node index.js and invoke tools via MCP protocols supported by your client.