This MCP server connects to a Shopify store and exposes tools to retrieve data from your store. It provides two tools: get-product-list and get-customer-list. The get-product-list tool fetches products from Shopify and supports an optional limit parameter to control how many products are returned (default is 10). The get-customer-list tool fetches customers from Shopify and also supports an optional limit parameter (default is 10). To use the server, start it locally and invoke these tools through your MCP client. The server handles the Shopify API calls using the configured credentials from environment variables and returns structured results that include product and customer details as described in the tool documentation.

Prerequisites:

• Python 3.12 or higher
• A Shopify store with API access and credentials (API Key, Password, Access Token)
• uv (for dependency management) or a Python virtual environment

Steps:

1. Clone the repository: git clone https://github.com/siddhantbajaj/shopify-mcp-server.git cd shopify-mcp-server

2. Create and activate a virtual environment using uv: uv venv source .venv/bin/activate # On Unix/MacOS

   or

   .venv\Scripts\activate # On Windows

3. Install the package in editable mode: uv pip install -e .

4. Create a .env file in the project root with your Shopify credentials: SHOPIFY_SHOP_URL="your-store.myshopify.com" SHOPIFY_API_KEY="your_api_key" SHOPIFY_PASSWORD="your_api_password" SHOPIFY_ACCESS_TOKEN="your_access_token"

5. Run the MCP server: python -m shopify_mcp_server.server

Note: Ensure your environment variables are loaded before starting the server. If you prefer, you can export them in your shell session instead of using a .env file.

Tips and common issues:

• Do not commit the .env file to version control; store credentials securely.
• Ensure the Shopify store URL is correctly formatted (e.g., your-store.myshopify.com).
• If API permissions are missing, verify that the API key/password/access token have read access to Products and Customers.
• When testing locally, you can increase the default limit for get-product-list and get-customer-list by passing a higher value through your MCP client.
• The server uses the Shopify Python API under the hood; ensure network access to Shopify endpoints is available from your environment.