PrestaShop

You can manage every aspect of your PrestaShop store through natural language with this MCP Server. It exposes comprehensive tooling for products, categories, customers, orders, modules, cache, themes, and the main navigation, enabling AI-assisted administration and automation.

How to use

Connect your MCP client to the server and start the local python process that runs the MCP server. You can run the server in a virtual environment, then invoke it with Python to expose the full set of store management features to your AI integrations.

How to install

Prerequisites you need before installation: a supported Python environment, a virtual environment tool, and network access to install dependencies.

Windows installation steps (recommended to isolate dependencies in a virtual environment):

# 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)"

Linux/macOS installation steps (isolated in a virtual environment):

# 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

Configuration

Create a configuration file or environment variables to point the MCP server at your PrestaShop store. The server reads these values at startup to connect to the store and manage data.

# Example environment variables for the store connection
PRESTASHOP_SHOP_URL=https://your-shop.example.com
PRESTASHOP_API_KEY=YOUR_API_KEY

# Logging
LOG_LEVEL=INFO

Usage with Claude Desktop

Run the MCP server as a local process and configure Claude Desktop to launch it. The server can run in a virtual environment and is accessed via a Python module entry point.

Windows configuration snippet for Claude Desktop to start the server from a virtual environment:

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"
      }
    }
  }
}

💻 CLI usage

Activate the virtual environment, then run the MCP server from the command line. You can also pass API connection details directly.

# Linux/macOS
source venv_prestashop/bin/activate
prestashop-mcp

# Or with explicit parameters
prestashop-mcp --shop-url https://your-shop.com --api-key YOUR_API_KEY

# Debug mode
prestashop-mcp --log-level DEBUG

🆕 Extended functionality examples

Interact with the store using natural language to manage modules, menus, cache, themes, and products. See the tool names and examples below for typical prompts you can use.

🧭 Unified Product API

The product retrieval endpoint supports multiple use cases in a single interface. You can fetch a single product with stock and category data, list products with filters, or request enhanced fields to tailor the response to your needs.

🧰 Advanced features and troubleshooting

Access and manage the main navigation, theme settings, and cache status. If you encounter issues starting the server, ensure the virtual environment is active and the required environment variables are set.

🧪 Development

Run the test suite to validate functionality and ensure compatibility with your PrestaShop setup.

📝 Project notes

This MCP Server provides a structured interface for AI-driven management of a PrestaShop store, with tools covering products, categories, customers, orders, modules, menus, cache, and themes.

Available tools

get_products

Retrieve products with flexible filtering, stock and category enrichment, and field selection. Supports single product by ID, multiple products with limits, and enhanced results with optional details.

create_product

Create a new product with complete configuration including price, stock, categories, and custom fields.

update_product

Edit product information such as name, description, price, and attributes.

delete_product

Remove a product from the catalog.

update_product_stock

Adjust inventory levels for products across warehouses or stock locations.

update_product_price

Update pricing details for products or specific variants.

get_categories

Retrieve category structure with optional hierarchy filtering.

create_category

Create a new category with parent-child relationships.

update_category

Edit category properties such as name and parent.

delete_category

Remove a category from the store.

get_customers

Retrieve and filter customer records.

create_customer

Create a new customer profile with contact information.

update_customer

Edit customer details such as address, contact info, and preferences.

get_orders

Retrieve and filter orders by status, date, and customer criteria.

update_order_status

Change the status of an order (e.g., processing, shipped, delivered).

get_order_states

Retrieve available order statuses.

get_modules

List all PrestaShop modules with their status.

get_module_by_name

Get detailed information for a specific module.

install_module

Install a new module into the store.

update_module_status

Activate or deactivate a module.

get_main_menu_links

Retrieve main navigation links (ps_mainmenu).

update_main_menu_link

Edit existing navigation links.

add_main_menu_link

Add a new navigation link to the main menu.

clear_cache

Clear PrestaShop cache across all types.

get_cache_status

Monitor current cache configuration and status.

get_themes

Retrieve information about the current theme.

update_theme_setting

Configure theme settings and related assets.

test_connection

Test the API connection to the PrestaShop store.

get_shop_info

Provide comprehensive statistics about the store.