Skip to main content
Glama

WooCommerce Enterprise MCP Suite

by Maxli53

WooCommerce Enterprise MCP Suite

A comprehensive enterprise-level Model Context Protocol (MCP) integration for WooCommerce, providing 100+ tools for complete store management through Claude Desktop. This suite offers full WooCommerce REST API coverage with advanced multi-store management, automation, and safety features.

๐Ÿš€ Key Features

Enterprise Capabilities

  • โœ… 100+ MCP Tools - Complete WooCommerce REST API coverage

  • โœ… Multi-Store Management - Manage unlimited stores from single interface

  • โœ… Store Cloning - Complete store replication with localization

  • โœ… Bulk Operations - Safe bulk processing with preview and rollback

  • โœ… Multi-Language Support - Complete translation management

  • โœ… Multi-Currency - Regional pricing and currency conversion

  • โœ… Theme Management - Customization and branding tools

  • โœ… SEO Optimization - Advanced SEO and marketing tools

  • โœ… Performance Monitoring - Real-time metrics and alerts

  • โœ… Automated Backups - Scheduled backups with restore capabilities

Safety & Security

  • ๐Ÿ›ก๏ธ Dry-Run Mode - Preview all changes before execution

  • ๐Ÿ”„ Automatic Rollback - Revert on errors

  • ๐Ÿ’พ Backup Before Changes - Automatic safety snapshots

  • โšก Rate Limiting - Prevent API overload

  • โœ”๏ธ Validation - Input validation and error checking

๐Ÿ—๏ธ Architecture

The suite is organized into two complementary systems:

System 1: Web Platform

  • Location: /web-platform/

  • Purpose: Browser-based management interface

  • Features: Multi-store dashboard, visual analytics, REST API

System 2: Claude Desktop MCP (Enhanced)

  • Location: /claude-desktop-mcp/enhanced/

  • Purpose: AI-powered store management through Claude

  • Features: 100+ MCP tools, natural language interface, automation

๐Ÿ“ Project Structure

MCP/ โ”œโ”€โ”€ ARCHITECTURE.md # Detailed architecture documentation โ”œโ”€โ”€ README.md # This file (comprehensive guide) โ”œโ”€โ”€ TOOL_REFERENCE.md # Complete API reference for all 100+ tools โ”œโ”€โ”€ CREDENTIALS.md # Credential management guide โ”‚ โ”œโ”€โ”€ web-platform/ # System 1: Web Management Platform โ”‚ โ”œโ”€โ”€ README.md # Web platform documentation โ”‚ โ”œโ”€โ”€ main.py # FastAPI application entry โ”‚ โ”œโ”€โ”€ web_server.py # Web server implementation โ”‚ โ””โ”€โ”€ src/ # Application source code โ”‚ โ”œโ”€โ”€ claude-desktop-mcp/ # System 2: Claude Desktop Integration โ”‚ โ”œโ”€โ”€ enhanced/ # Enhanced MCP implementation (100+ tools) โ”‚ โ”‚ โ”œโ”€โ”€ core.py # Main MCP server with all tools โ”‚ โ”‚ โ”œโ”€โ”€ multi_store.py # Multi-store management system โ”‚ โ”‚ โ”œโ”€โ”€ store_cloner.py # Store cloning functionality โ”‚ โ”‚ โ”œโ”€โ”€ bulk_operations.py # Safe bulk processing โ”‚ โ”‚ โ””โ”€โ”€ tools/ # Enhanced tool modules โ”‚ โ”‚ โ”œโ”€โ”€ products_enhanced.py # Product management (15+ tools) โ”‚ โ”‚ โ”œโ”€โ”€ orders_enhanced.py # Order management (12+ tools) โ”‚ โ”‚ โ”œโ”€โ”€ customers.py # Customer management (10+ tools) โ”‚ โ”‚ โ”œโ”€โ”€ multi_language.py # Language & currency (8+ tools) โ”‚ โ”‚ โ”œโ”€โ”€ store_config.py # Store configuration (6+ tools) โ”‚ โ”‚ โ”œโ”€โ”€ theme_manager.py # Theme & branding (8+ tools) โ”‚ โ”‚ โ”œโ”€โ”€ content_manager.py # Content management (10+ tools) โ”‚ โ”‚ โ”œโ”€โ”€ seo_marketing.py # SEO & marketing (10+ tools) โ”‚ โ”‚ โ””โ”€โ”€ monitoring.py # Monitoring & health (7+ tools) โ”‚ โ”œโ”€โ”€ mcp_server.py # Basic MCP server (legacy) โ”‚ โ””โ”€โ”€ config.ridebase.json # RideBase.fi configuration โ”‚ โ”œโ”€โ”€ shared/ # Shared components โ”‚ โ”œโ”€โ”€ woocommerce_api/ # WooCommerce API wrapper โ”‚ โ””โ”€โ”€ models/ # Data models โ”‚ โ””โ”€โ”€ backups/ # Store backup directory

๐Ÿ› ๏ธ Tool Categories (100+ Tools)

Product Management (15+ tools)

create_product, update_product, bulk_update_products, manage_variations, import_products, export_products, duplicate_product, manage_inventory, set_sale_prices, manage_categories, manage_tags, product_reviews, cross_sells_upsells, product_attributes, product_search

Order Management (12+ tools)

get_orders, create_order, update_order_status, bulk_fulfill_orders, process_refunds, generate_invoices, print_shipping_labels, track_shipments, order_notes, recurring_orders, abandoned_cart_recovery, sales_analytics

Customer Management (10+ tools)

get_customers, create_customer, update_customer, customer_segments, loyalty_programs, customer_analytics, export_customers, import_customers, merge_customers, customer_communications

Multi-Store Management (8+ tools)

add_store, sync_stores, clone_store, compare_stores, bulk_store_updates, store_migration, regional_settings, store_permissions

Content & SEO (10+ tools)

manage_pages, create_blog_posts, optimize_seo, generate_sitemaps, meta_tags_management, schema_markup, content_translation, image_optimization, url_redirects, analytics_integration

Monitoring & Health (7+ tools)

monitor_performance, health_check, create_backup, restore_backup, error_logs, uptime_monitoring, alert_management

๐Ÿš€ Quick Start

Option 1: Web Platform

cd web-platform setup_webapp.bat start_webapp.bat

โ†’ Opens browser at http://localhost:8000

Option 2: Claude Desktop MCP

cd claude-desktop-mcp # Configure environment variables in Claude Desktop # Restart Claude Desktop

โ†’ Use Claude Desktop to manage your store

๐Ÿ“Š System Comparison

Feature

Web Platform

Enhanced Claude MCP

Interface

Web browser

Claude Desktop

MCP Tools

N/A

100+ tools

Stores

Multiple

Unlimited

Store Cloning

Manual

Automated

Setup

Medium

Simple

Storage

Database

In-memory + backups

Bulk Operations

โœ… Yes

โœ… Yes (with safety)

API Access

โœ… REST API

โœ… Full coverage

Multi-Language

Basic

โœ… Complete

Multi-Currency

Basic

โœ… Advanced

Monitoring

Basic

โœ… Real-time

Backup/Restore

Manual

โœ… Automated

Best For

Web UI needs

Enterprise automation

๐Ÿ“‹ Requirements

  • Python: 3.11+ (required for pandas/numpy)

  • OS: Windows 10/11

  • RAM: 2GB minimum

  • WooCommerce: REST API enabled

๐Ÿ”ง Installation

Prerequisites

  • Python 3.9+ (3.11+ recommended)

  • Node.js 16+ (for Claude Desktop)

  • WooCommerce store with REST API enabled

  • Windows 10/11 or Linux/macOS

Setup Steps

  1. Clone the repository:

git clone https://github.com/yourusername/woocommerce-mcp-suite.git cd MCP
  1. Install Python dependencies:

python -m venv venv .\venv\Scripts\activate # Windows # source venv/bin/activate # Linux/Mac pip install fastmcp woocommerce httpx python-dotenv beautifulsoup4 PyQt6 pandas
  1. Configure store credentials:

# Copy example configuration cp .env.example .env # Edit .env with your WooCommerce credentials # STORE_URL=https://yourstore.com # CONSUMER_KEY=ck_xxxxx # CONSUMER_SECRET=cs_xxxxx
  1. Configure Claude Desktop for Enhanced MCP:

// Add to %APPDATA%\Claude\claude_desktop_config.json { "mcpServers": { "woocommerce-enterprise": { "command": "C:\\path\\to\\venv\\Scripts\\python.exe", "args": ["C:\\path\\to\\claude-desktop-mcp\\enhanced\\core.py"], "env": { "STORE_URL": "https://yourstore.com", "CONSUMER_KEY": "ck_xxxxx", "CONSUMER_SECRET": "cs_xxxxx" } } } }
  1. Restart Claude Desktop to load the enhanced MCP server

๐Ÿ“š Documentation

๐Ÿ’ก Usage Examples

Multi-Store Management

# Clone store to new region with localization clone_store({ "source_store_id": "main", "target_config": { "name": "EU Store", "url": "https://eu.store.com", "language": "de", "currency": "EUR" }, "clone_options": { "products": true, "transform_prices": true, "currency_conversion_rate": 1.1 } }) # Sync inventory across all stores sync_multi_store({ "sync_type": "inventory", "source_store": "main", "target_stores": ["eu", "uk", "us"], "conflict_resolution": "source_wins" })

Bulk Operations with Safety

# Preview changes before applying bulk_update_products({ "product_ids": [123, 124, 125], "updates": {"sale_price": "39.99"}, "safety_config": { "dry_run": true, # Preview mode "backup_before": true, "rollback_on_error": true } })

Advanced Analytics

# Comprehensive sales analysis get_sales_analytics({ "date_range": "last_30_days", "grouping": "day", "metrics": ["revenue", "orders", "average_order_value"], "compare_period": "previous_period", "segment_by": "customer_type" })

Automated Monitoring

# Setup 24/7 monitoring with alerts setup_monitoring_schedule({ "monitoring_interval_minutes": 15, "backup_interval_hours": 6, "health_check_interval_minutes": 5, "alert_thresholds": { "api_response_time": 3.0, "error_rate": 5.0 } })

๐ŸŽฏ Use Cases

Enterprise Use Cases

  • Multi-Region Expansion: Clone and localize stores for new markets

  • Inventory Synchronization: Real-time sync across all locations

  • Dynamic Pricing: Automated regional pricing with currency conversion

  • Bulk Migration: Import/export entire product catalogs

  • SEO Optimization: Multilingual SEO with schema markup

  • Performance Monitoring: 24/7 health checks with alerts

  • Disaster Recovery: Automated backups with quick restore

  • Customer Analytics: Segment analysis and lifetime value tracking

  • Order Automation: Bulk fulfillment and invoice generation

  • Content Management: Multi-language content with translations

๐Ÿ”’ Security Best Practices

  1. Never commit credentials - Use environment variables

  2. Rotate API keys regularly - Update keys monthly

  3. Use read-only keys when possible - Limit permissions

  4. Enable API request logging - Maintain audit trail

  5. Implement IP whitelisting - Restrict access

  6. Use HTTPS only - Encrypted connections

  7. Regular security audits - Check for vulnerabilities

โšก Performance Optimization

  1. Use Bulk Operations - Process multiple items in single request

  2. Enable Caching - Cache frequently accessed data

  3. Optimize Queries - Use specific fields parameter

  4. Implement Pagination - Process large datasets in chunks

  5. Schedule Heavy Tasks - Run intensive operations during off-peak

  6. Monitor API Limits - Stay within rate limits

  7. Use Async Operations - Non-blocking for better performance

๐Ÿ”„ Migration from Legacy

If you're using the combined mcp-woocommerce-suite/ version:

  1. Backup your data: data/ folder contains stores config

  2. Choose your system: Web Platform or Claude MCP

  3. Follow setup: In the chosen system's README

  4. Migrate config: Copy store credentials to new system

๐Ÿงช Testing

Run Tests

# Unit tests python -m pytest tests/unit # Integration tests python -m pytest tests/integration # Test specific tool python -m pytest tests/tools/test_products.py

Test Coverage

python -m pytest --cov=claude-desktop-mcp/enhanced --cov-report=html

๐Ÿ› ๏ธ Development

Each system can be developed independently:

Web Platform Development

cd web-platform python main.py --debug

Claude MCP Development

cd claude-desktop-mcp python mcp_server.py

๐Ÿ“ˆ Monitoring Dashboard

Access real-time metrics and health status:

get_monitoring_dashboard() # Returns: # - Current performance metrics # - Health check results # - Recent alerts # - Backup status # - System statistics

๐ŸŒ Multi-Language & Currency

Supported languages: EN, DE, FR, ES, IT, NL, PT, SV, FI, NO, DA Supported currencies: USD, EUR, GBP, SEK, NOK, DKK, CHF, AUD, CAD

๐Ÿ“ License

MIT License - See LICENSE file for details

๐Ÿค Support

  • Documentation: See TOOL_REFERENCE.md for complete API reference

  • Architecture: Review ARCHITECTURE.md for system design

  • Issues: Report bugs via GitHub Issues

  • Logs: Check data/logs/ for troubleshooting

  • Requirements: Python 3.9+, WooCommerce REST API enabled

๐Ÿ† Version History

Version 2.0.0 (2025-01-26) - Enterprise Edition

  • โœจ Complete architectural refactoring into dual-system design

  • ๐Ÿš€ Added 100+ MCP tools for full WooCommerce API coverage

  • ๐ŸŒ Implemented multi-store management with synchronization

  • ๐Ÿ”„ Added store cloning with localization support

  • ๐Ÿ’ฑ Integrated multi-language and currency management

  • ๐Ÿ“Š Built comprehensive monitoring and backup systems

  • ๐Ÿ›ก๏ธ Added enterprise-level safety features (dry-run, rollback)

  • โšก Performance optimizations for large-scale operations

Version 1.0.0 (2025-01-20) - Initial Release

  • Basic WooCommerce integration

  • Web platform for store management

  • Simple MCP tools for Claude Desktop


๐Ÿš€ Get Started:

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides 115+ MCP tools for comprehensive WooCommerce store management including multi-store operations, bulk processing, inventory sync, order management, and customer analytics. Features enterprise-level safety controls with dry-run mode, automatic backups, and rollback capabilities.

  1. ๐Ÿš€ Key Features
    1. Enterprise Capabilities
    2. Safety & Security
  2. ๐Ÿ—๏ธ Architecture
    1. System 1: Web Platform
    2. System 2: Claude Desktop MCP (Enhanced)
  3. ๐Ÿ“ Project Structure
    1. ๐Ÿ› ๏ธ Tool Categories (100+ Tools)
      1. Product Management (15+ tools)
      2. Order Management (12+ tools)
      3. Customer Management (10+ tools)
      4. Multi-Store Management (8+ tools)
      5. Content & SEO (10+ tools)
      6. Monitoring & Health (7+ tools)
    2. ๐Ÿš€ Quick Start
      1. Option 1: Web Platform
      2. Option 2: Claude Desktop MCP
    3. ๐Ÿ“Š System Comparison
      1. ๐Ÿ“‹ Requirements
        1. ๐Ÿ”ง Installation
          1. Prerequisites
          2. Setup Steps
        2. ๐Ÿ“š Documentation
          1. ๐Ÿ’ก Usage Examples
            1. Multi-Store Management
            2. Bulk Operations with Safety
            3. Advanced Analytics
            4. Automated Monitoring
          2. ๐ŸŽฏ Use Cases
            1. Enterprise Use Cases
          3. ๐Ÿ”’ Security Best Practices
            1. โšก Performance Optimization
              1. ๐Ÿ”„ Migration from Legacy
                1. ๐Ÿงช Testing
                  1. Run Tests
                  2. Test Coverage
                2. ๐Ÿ› ๏ธ Development
                  1. Web Platform Development
                  2. Claude MCP Development
                3. ๐Ÿ“ˆ Monitoring Dashboard
                  1. ๐ŸŒ Multi-Language & Currency
                    1. ๐Ÿ“ License
                      1. ๐Ÿค Support
                        1. ๐Ÿ† Version History
                          1. Version 2.0.0 (2025-01-26) - Enterprise Edition
                          2. Version 1.0.0 (2025-01-20) - Initial Release

                        Related MCP Servers

                        • -
                          security
                          A
                          license
                          -
                          quality
                          This MCP server connects clients with Shopify store data, enabling retrieval of product and customer information via exposed tools.
                          Last updated -
                          4
                          MIT License
                        • -
                          security
                          A
                          license
                          -
                          quality
                          WooCommerce MCP Server enables interaction with WooCommerce stores through the WordPress REST API. It provides comprehensive tools for managing all aspects of products, orders, customers, shipping, taxes, discounts, and store configuration using JSON-RPC 2.0 protocol.
                          Last updated -
                          67
                          MIT License
                          • Apple
                          • Linux
                        • -
                          security
                          A
                          license
                          -
                          quality
                          This read-only MCP Server allows you to connect to WooCommerce data from Claude Desktop through CData JDBC Drivers. Free (beta) read/write servers available at https://www.cdata.com/solutions/mcp
                          Last updated -
                          MIT License
                          • Apple
                          • Linux
                        • -
                          security
                          F
                          license
                          -
                          quality
                          A comprehensive toolkit that consolidates over 40 development tools into a single MCP, enabling unified management of frontend, backend, mobile development, GitHub repositories, and database operations.

                        View all related MCP servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/Maxli53/MCP_woo'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server