MCP Server • Production Ready • v0.4.0

WooCommerce MCP Server

Complete store management with natural language queries. Products, inventory, categories, images, bulk operations, and business intelligence for 7,000+ products.

30+
Tools
7K+
Products
90%
Context Reduction
🤖
AI-Powered

Quick Start

1. Installation

git clone https://github.com/username/woocommerce-mcp.git
cd woocommerce-mcp
pip install -e .

2. Configuration

Create .env file with your WooCommerce credentials:

WOO_URL=https://yourstore.com
WOO_CONSUMER_KEY=ck_xxxxxxxxxxxxx
WOO_CONSUMER_SECRET=cs_xxxxxxxxxxxxx

Or run the setup wizard: woo-mcp-setup

3. Claude Desktop Configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "woocommerce": {
      "command": "python",
      "args": ["-m", "woocommerce_mcp.server"],
      "cwd": "/path/to/woocommerce-mcp"
    }
  }
}

4. First Commands in Your AI Assistant

  • • "How many products do I have?"
  • • "Show me products with low stock"
  • • "What are my top-selling categories?"
  • • "Give me a daily operations summary"

Key Features

🤖

Natural Language Queries

Ask questions in plain English. Smart intent detection with 90% less context usage.

🚀

Bulk Operations

Update thousands of products with natural language instructions and safety checks.

📊

Business Intelligence

Daily operations dashboard with actionable insights and critical alerts.

📦

Inventory Management

Stock updates, low stock alerts, comprehensive reports with value calculations.

🖼️

Image Management

Upload, attach, and manage product images. Bulk operations for efficiency.

📈

Deep Analytics

Sales velocity, profitability analysis, inventory turnover metrics.

All 30+ Tools Reference

🛍️ Product Tools (7)

product_list

List products with filters (status, category, stock status, search)

product_get

Get a single product by ID or SKU

product_create

Create a new product with full details

product_update

Update an existing product

product_delete

Delete a product permanently or move to trash

product_batch_create

Create multiple products at once

product_batch_update

Update multiple products at once

📦 Inventory Tools (5)

inventory_update_stock

Update stock for a single product (set, increase, decrease)

inventory_bulk_update_stock

Update stock for multiple products at once

inventory_get_low_stock

Get products with low stock alerts

inventory_stock_status

Update stock status (in stock, out of stock, on backorder)

inventory_report

Generate comprehensive inventory report with value calculations

🏷️ Category Tools (5)

category_list

List all categories with hierarchy

category_create

Create a new category with parent support

category_assign

Assign categories to a product

category_update

Update category details

category_delete

Delete a category

🖼️ Image Tools (5)

image_upload

Upload an image to WordPress media library

image_attach_to_product

Attach images to a product gallery

image_set_featured

Set a product's featured image

image_remove_from_product

Remove images from a product

image_bulk_upload

Upload multiple images from a directory

📊 Import/Export Tools (4)

import_products_from_json

Import products from JSON file with validation

import_products_from_csv

Import products from CSV with field mapping

export_products

Export products to JSON or CSV format

import_validate

Validate import data before processing

🤖 Natural Language & BI (3)

query_store

Query your store using natural language (90% context reduction)

daily_operations_summary

Comprehensive store overview with actionable insights

smart_product_search

Intelligent search with semantic understanding

🚀 Bulk Operations & Analytics (4)

bulk_update_natural

Execute bulk updates using natural language with safety features

product_analytics

Deep analytics (sales velocity, profitability, inventory turnover)

ai_agent_task

Create async automation tasks with webhook support

get_task_status

Check status of async tasks

Enhancement Tools (5)

Specialized tools for managing AI enhancement workflow across 7,000+ products:

  • get_products_for_layer - Get products needing work on specific enhancement layer
  • update_product_field - Update single field without touching other fields
  • batch_update_field - Update same field across multiple products
  • get_enhancement_progress - Detailed progress by enhancement layer
  • get_similar_products_for_context - Find similar products with completed enhancements

Common Use Cases

Daily Store Management

  • • "How many products do I have?"
  • • "Show me products with low stock"
  • • "What are my top-selling categories?"
  • • "Give me a daily operations summary"

Bulk Operations

  • • Update prices for entire category
  • • Add tags to multiple products
  • • Bulk image uploads and attachments
  • • Mass inventory adjustments

AI Product Enhancement

  • • Track enhancement progress by layer
  • • Get products needing specific work
  • • Find similar products for context
  • • Batch update enhanced fields

Analytics & Insights

  • • Sales velocity analysis
  • • Profitability tracking
  • • Inventory turnover metrics
  • • Critical alerts and recommendations

Real-World Example: e-commerce AI Platform

This MCP server powers the AI-enhanced specialty e-commerce platform with 7,105 products and 12,770+ optimized images.

The Challenge

  • • 7,105 products needing AI enhancement
  • • Multiple enhancement layers (descriptions, SEO, specs)
  • • Manual WooCommerce interface too slow
  • • Need for bulk operations and tracking

The Solution

  • • Natural language queries for quick insights
  • • Bulk enhancement operations via AI assistants
  • • Progress tracking by layer
  • • Context retrieval from similar products

Result:

AI-first e-commerce platform ready for the post-Google search era with RAG system, computer vision capabilities, and voice commerce integration.

Technical Details

Tech Stack

  • Language: Python 3.13+
  • API: WooCommerce REST API
  • Framework: MCP (Model Context Protocol)
  • NLP: Natural language processing for queries
  • Cache: Intelligent caching for instant queries

Performance

  • Context Reduction: 90% less for repeated queries
  • Batch Size: Up to 100 products per operation
  • Response Time: <1s for cached queries
  • Scalability: Tested with 7,000+ products

Safety Features

  • Validation: Pre-import data validation
  • Dry Run: Preview bulk operations
  • Rate Limiting: API call management
  • Error Handling: Comprehensive error messages

Version History

  • v0.4.0: Bulk ops & analytics
  • v0.3.0: Business intelligence
  • v0.2.0: Natural language queries
  • v0.1.0: Core functionality

Related Projects

Manage Your Store with Natural Language

Production-ready MCP server for WooCommerce with 30+ tools and AI-powered automation.