Shopify Python MCP Server

This is an MCP server that works with the Shopify API. By using this server, you can retrieve and manipulate Shopify product information from Claude Desktop.

function

tool

The server provides the following tools:

list_products : Get a list of products
- limit : Number of items to retrieve (maximum 250, default value 50)
get_product : Get detailed product information
- product_id : Product ID (required)
create_product : Create a new product
- title : Product name (required)
- body_html : Product description (HTML format)
- vendor : Vendor name
- product_type : Product type
- tags : tags (comma separated)
- status : Status (active/draft/archived)
- variants
- options : options
- images : Images
update_product : Update a product
- product_id : Product ID (required)
- title : Product name
- body_html : Product description (HTML format)
- vendor : Vendor name
- product_type : Product type
- tags : tags (comma separated)
- status : Status (active/draft/archived)
- variants
- options : options
- images : Images
delete_product : Delete a product
- product_id : Product ID (required)

setting

Required Environment Variables

To use this server, you must set the following environment variables:

SHOPIFY_SHOP_URL : Your Shopify store URL (e.g. mystore.myshopify.com)
SHOPIFY_API_KEY : Shopify Admin API key
SHOPIFY_API_PASSWORD : Shopify Admin API password (Secret)
SHOPIFY_API_VERSION : Shopify API version (default: 2023-10)

Claude Desktop settings

If you are using Claude Desktop, add the following settings to claude_desktop_config.json:

macOS

Configuration file location: ~/Library/Application Support/Claude/claude_desktop_config.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"
    }
  }
}

How to use

To use this server with Claude Desktop, call the tool as follows:

Get product list

商品一覧を取得してください。

Get detailed product information

商品ID 1234567890の詳細情報を取得してください。

Creating a new product

以下の情報で新しい商品を作成してください：
- 商品名: サンプル商品
- 説明: これはサンプル商品です。
- 価格: 1000円

Product Updates

商品ID 1234567890を以下の情報で更新してください：
- 商品名: 更新後の商品名
- 価格: 2000円

Remove a product

商品ID 1234567890を削除してください。

development

Installing dependencies

cd shopify-py-mcp
uv sync --dev --all-extras

debug

You can debug using MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /your_path/shopify-py-mcp run shopify-py-mcp

Build and publish

To prepare a package for distribution:

Sync dependencies and update lock files:

uv sync

Build the package:

uv build

Published to PyPI:

uv publish

Note: You will need to set your PyPI credentials via environment variables or command flags:

Token: --token or UV_PUBLISH_TOKEN
Or username/password: --username / UV_PUBLISH_USERNAME and --password / UV_PUBLISH_PASSWORD

Shopify Python MCP Server

Integrations