PrestaShop MCP Server

A server for managing PrestaShop e-commerce stores through a unified product API.

A professional Model Context Protocol (MCP) Server for complete management of PrestaShop e-commerce stores withextended functionality.

This MCP Server enables complete management of your PrestaShop store through AI applications like Claude Desktop. With specialized tools, you can manage all aspects of your e-commerce business - from products and categories to customers, orders,modules, cache, themes, and navigation menus.

- 🛍️ Complete Store Management- Tools for all e-commerce areas
- 🔧 Module Management- Install, activate, deactivate modules
- 💾 Cache Management- Clear and monitor cache status
- 🎨 Theme Management- Configure themes and settings
- 📋 Menu Management- Manage main navigation (ps_mainmenu)
- 🏗️ MCP Protocol Compliancefor seamless AI integration
- ⚡ Async/Await Architecturefor maximum performance
- 🛡️ Comprehensive Error Handlingand validation
- 🔧 Production-Readywith complete test suite
- 📖 Comprehensive Documentationwith practical examples

- get_products-UNIFIEDProduct retrieval supporting all use cases:

- Single Product by ID: Complete product details including stock and category info
- Multiple Products: List with optional filtering and enhancement
- Flexible Enhancement: Optional stock info, category details, custom field selection
- Smart Filtering: By category, name, or custom criteria

- get_categories- Retrieve categories (with hierarchy filter)
- create_category- Create new categories
- update_category- Edit categories
- delete_category- Remove categories

- get_customers- Retrieve and filter customers
- create_customer- Create new customers
- update_customer- Edit customer data

- get_orders- Retrieve and filter orders
- update_order_status- Change order status
- get_order_states- Retrieve available statuses

- get_modules- List all PrestaShop modules
- get_module_by_name- Get specific module details
- install_module- Install new modules
- update_module_status- Activate/deactivate modules

- get_main_menu_links- Retrieve ps_mainmenu navigation links
- update_main_menu_link- Edit existing menu links
- add_main_menu_link- Add new navigation links

- clear_cache- Clear PrestaShop cache (all types)
- get_cache_status- Monitor cache configuration

- get_themes- Get current theme information
- update_theme_setting- Configure theme settings

- test_connection- Test API connection
- get_shop_info- Comprehensive store statistics

⚠️ Recommended Installation (Virtual Environment)

This approach prevents module conflicts and ensures reliable installation:

# Clone repository git clone https://github.com/latinogino/prestashop-mcp.git cd prestashop-mcp # Create virtual environment python -m venv venv_prestashop # Activate virtual environment .\venv_prestashop\Scripts\Activate.ps1 # Install dependencies pip install -r requirements.txt # Install package in development mode pip install -e . # Verify installation python -c "import prestashop_mcp; print('✅ Installation successful')" # Note the Python path for Claude Desktop configuration Write-Host "Python Path: $((Get-Command python).Source)"

# Clone repository git clone https://github.com/latinogino/prestashop-mcp.git cd prestashop-mcp # Create virtual environment python3 -m venv venv_prestashop # Activate virtual environment source venv_prestashop/bin/activate # Install dependencies pip install -r requirements.txt # Install package in development mode pip install -e . # Verify installation python -c "import prestashop_mcp; print('✅ Installation successful')" # Note the Python path for Claude Desktop configuration which python

Create a.envfile based on.env.example:

# PrestaShop Configuration PRESTASHOP_SHOP_URL=https://your-shop.example.com PRESTASHOP_API_KEY=YOUR_API_KEY # Logging LOG_LEVEL=INFO

Add this configuration toclaude_desktop_config.json:

{ "mcpServers": { "prestashop": { "command": "C:\\\\path\\\\to\\\\prestashop-mcp\\\\venv_prestashop\\\\Scripts\\\\python.exe", "args": ["-m", "prestashop_mcp.prestashop_mcp_server"], "cwd": "C:\\\\path\\\\to\\\\prestashop-mcp", "env": { "PRESTASHOP_SHOP_URL": "https://your-shop.example.com", "PRESTASHOP_API_KEY": "YOUR_API_KEY" } } } }

{ "mcpServers": { "prestashop": { "command": "/path/to/prestashop-mcp/venv_prestashop/bin/python", "args": ["-m", "prestashop_mcp.prestashop_mcp_server"], "cwd": "/path/to/prestashop-mcp", "env": { "PRESTASHOP_SHOP_URL": "https://your-shop.example.com", "PRESTASHOP_API_KEY": "YOUR_API_KEY" } } } }

# Activate virtual environment first (if using venv) source venv_prestashop/bin/activate # Linux/macOS .\venv_prestashop\Scripts\Activate.ps1 # Windows # With environment variables prestashop-mcp # With direct parameters prestashop-mcp --shop-url https://your-shop.com --api-key YOUR_API_KEY # Debug mode prestashop-mcp --log-level DEBUG

"Show me all modules in my PrestaShop store" "Activate the ps_mainmenu module" "Deactivate the blockcart module" "Get details for the ps_featuredproducts module"

"Show me all main menu links" "Add a new menu link called 'Special Offers' pointing to /special-offers" "Update menu link 3 to point to /new-products" "Make menu link 5 inactive"

"Clear all PrestaShop cache" "Show me the current cache status" "Check if CSS cache is enabled"

"Show me current theme settings" "Update the PS_LOGO setting to /img/new-logo.png" "Change the PS_THEME_NAME to my-custom-theme"

Theget_productstool handlesall product retrieval scenarioswith a single, powerful interface:

The ps_mainmenu module management allows you to:

- Retrieve all main navigation links
- Add custom navigation items
- Update existing menu links (name, URL, status)
- Control menu link positioning

- Clear all cache types (CSS, JS, Template, General)
- Monitor cache status for performance optimization
- Toggle cache settings for development/production

- List all installed modules with status
- Install new modules programmatically
- Activate/deactivate modules as needed
- Get detailed module information

- View current theme configuration
- Update theme-specific settings
- Manage logos and visual elements
- Configure theme-related PrestaShop settings

"ModuleNotFoundError: No module named 'prestashop_mcp'"

Solution:Use virtual environment and ensure package is installed:

# Check if in virtual environment python -c "import sys; print(sys.prefix)" # Reinstall package pip install -e . # Verify installation python -c "import prestashop_mcp; print('Module found')"

# Ensure your API key has module management permissions curl -u "YOUR_API_KEY:" https://your-shop.com/api/modules?output_format=JSON

Alternative Cache Clear:If the API-based cache clear doesn't work, you may need to:
- Check PrestaShop permissions for API user
- Use manual cache clearing in PrestaShop admin
- Verify cache directory write permissions

Enable debug logging in Claude Desktop configuration:

{ "mcpServers": { "prestashop": { "command": "path/to/python", "args": ["-m", "prestashop_mcp.prestashop_mcp_server"], "cwd": "path/to/prestashop-mcp", "env": { "PRESTASHOP_SHOP_URL": "https://your-shop.example.com", "PRESTASHOP_API_KEY": "YOUR_API_KEY", "LOG_LEVEL": "DEBUG" } } } }

prestashop-mcp/ ├── src/prestashop_mcp/ # Main Package │ ├── prestashop_mcp_server.py # MCP Server (Extended) │ ├── prestashop_client.py # PrestaShop API Client (Extended) │ ├── config.py # Configuration Management │ └── cli.py # Command Line Interface ├── tests/ # All Tests │ ├── test_config.py # Unit Tests │ └── test_crud_operations.py # CRUD Integration Tests ├── venv_prestashop/ # Virtual Environment (after setup) ├── README.md # Documentation ├── CHANGELOG.md # Version History ├── pyproject.toml # Package Configuration └── requirements.txt # All Dependencies

curl -u "API_KEY:" https://your-shop.com/api/configurations?output_format=JSON

- Products:/api/products
- Categories:/api/categories
- Customers:/api/customers
- Orders:/api/orders
- Stock:/api/stock_availables
- Order Status:/api/order_states
- Modules:/api/modulesNEW
- Configurations:/api/configurationsNEW

# Activate virtual environment source venv_prestashop/bin/activate # Linux/macOS .\venv_prestashop\Scripts\Activate.ps1 # Windows # All dependencies (including test dependencies) are in requirements.txt pip install -r requirements.txt # Run tests pytest # Run tests with coverage pytest --cov=src/prestashop_mcp --cov-report=html # Run comprehensive integration tests python tests/test_crud_operations.py

- PrestaShop Official Documentation
- Model Context Protocol Specification
- Claude Desktop MCP Integration
- GitHub Repository

SeeCHANGELOG.mdfor a detailed history of changes.

# Future Docker installation (planned) docker pull latinogino/prestashop-mcp:latest docker run -e PRESTASHOP_SHOP_URL=https://your-shop.com \ -e PRESTASHOP_API_KEY=your-key \ -p 8080:8080 \ latinogino/prestashop-mcp:latest

Integrate Hygraph directly into MCP-compatible tools like Claude and Cursor, executing content operations via natural language