shopify-py-mcp

# Shopify Python MCP Server This is an MCP server that integrates with the Shopify API. By using this server, you can retrieve and manipulate product information from Shopify through Claude Desktop. <a href="https://glama.ai/mcp/servers/zfff0mhppb"> <img width="380" height="200" src="https://glama.ai/mcp/servers/zfff0mhppb/badge" alt="Shopify Python Server MCP server" /> </a> ## Features ### Tools This server provides the following tools: 1. **list_products**: Retrieve a list of products - `limit`: Number of products to retrieve (maximum 250, default is 50) 2. **get_product**: Retrieve detailed information about a product - `product_id`: Product ID (required) 3. **create_product**: Create a new product - `title`: Product name (required) - `body_html`: Product description (in HTML format) - `vendor`: Vendor name - `product_type`: Product type - `tags`: Tags (comma-separated) - `status`: Status (active/draft/archived) - `variants`: Variants - `options`: Options - `images`: Images 4. **update_product**: Update a product - `product_id`: Product ID (required) - `title`: Product name - `body_html`: Product description (in HTML format) - `vendor`: Vendor name - `product_type`: Product type - `tags`: Tags (comma-separated) - `status`: Status (active/draft/archived) - `variants`: Variants - `options`: Options - `images`: Images 5. **delete_product**: Delete a product - `product_id`: Product ID (required) ## Configuration ### Required Environment Variables To use this server, you need to set the following environment variables: - `SHOPIFY_SHOP_URL`: URL of the Shopify store (e.g., mystore.myshopify.com) - `SHOPIFY_API_KEY`: API key for the Shopify Admin API - `SHOPIFY_API_PASSWORD`: API password (Secret) for the Shopify Admin API - `SHOPIFY_API_VERSION`: Version of the Shopify API (default: 2023-10) ### Configuration in Claude Desktop If you are using it with Claude Desktop, add the following configuration to `claude_desktop_config.json`: #### macOS Location of the configuration file: `~/Library/Application Support/Claude/claude_desktop_config.json` ```json "mcpServers": { "shopify-py-mcp": { "command": "uv", "args": [ "--directory", "/your_path/shopify-py-mcp", "run", "shopify-py-mcp" ], "env": { "SHOPIFY_SHOP_URL": "your-store.myshopify.com", "SHOPIFY_API_KEY": "your-api-key", "SHOPIFY_API_PASSWORD": "your-api-password", "SHOPIFY_API_VERSION": "2023-10" } } } ``` ## Usage To use this server in Claude Desktop, you can call the tools as follows: ### Retrieve Product List ``` Please retrieve the product list. ``` ### Retrieve Product Details ``` Please retrieve the details for product ID 1234567890. ``` ### Create a New Product ``` Please create a new product with the following information: - Product Name: Sample Product - Description: This is a sample product. - Price: 1000 yen ``` ### Update a Product ``` Please update product ID 1234567890 with the following information: - Product Name: Updated Product Name - Price: 2000 yen ``` ### Delete a Product ``` Please delete product ID 1234567890. ``` ## Development ### Install Dependencies ```bash cd shopify-py-mcp uv sync --dev --all-extras ``` ### Debugging You can debug using the MCP Inspector: ```bash npx @modelcontextprotocol/inspector uv --directory /your_path/shopify-py-mcp run shopify-py-mcp ``` ### Build and Publish To prepare the package for distribution: 1. Sync dependencies and update the lock file: ```bash uv sync ``` 2. Build the package: ```bash uv build ``` 3. Publish to PyPI: ```bash uv publish ``` Note: You need to set the PyPI credentials either through environment variables or command flags: - Token: `--token` or `UV_PUBLISH_TOKEN` - Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`