Content
# Shopify Admin MCP
MCP server for Shopify Admin API operations
[日本語版はこちら](README.ja.md)
## Setup
```bash
npm install
```
## Environment Variables
```
SHOPIFY_SHOP_DOMAIN=your-store.myshopify.com
SHOPIFY_ACCESS_TOKEN=shpat_xxxxx
```
## Claude Desktop Configuration
```json
{
"mcpServers": {
"shopify-admin": {
"command": "node",
"args": ["--experimental-strip-types", "/path/to/shopify-admin-mcp/src/index.ts"],
"env": {
"SHOPIFY_SHOP_DOMAIN": "your-store.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
}
}
}
}
```
## Available Tools
### System
| Tool | Description |
|------|-------------|
| `test_connection` | Test API connection |
### Products
| Tool | Description |
|------|-------------|
| `search_products` | Search products (by title, vendor, etc.) |
| `get_product` | Get product details (by ID or handle) |
| `create_product` | Create a new product with optional variants |
| `update_product` | Update product info (title, description, status, SEO, etc.) |
| `upload_product_image` | Add images to a product from public URLs |
| `get_monthly_ranking` | Get monthly sales ranking |
### Collections
| Tool | Description |
|------|-------------|
| `get_collections` | Search and list collections |
| `get_collection` | Get collection details |
| `create_collection` | Create a collection |
| `add_products_to_collection` | Add products and set sort order |
| `duplicate_collection` | Duplicate a collection |
### Blog
| Tool | Description |
|------|-------------|
| `get_blogs` | Get blog list |
| `get_articles` | Get article list |
| `create_article` | Create an article |
| `update_article` | Update an article |
### Theme
| Tool | Description |
|------|-------------|
| `get_themes` | Get theme list |
| `get_theme_asset` | Get theme file |
| `update_theme_asset` | Create or update theme file |
### Menu
| Tool | Description |
|------|-------------|
| `get_menus` | Get navigation menus with items |
| `update_menu` | Update a navigation menu |
### Discounts
| Tool | Description |
|------|-------------|
| `get_discounts` | List all discounts (code + automatic) |
| `get_discount` | Get a single discount detail by ID |
| `create_discount_code_basic` | Create a code discount (amount/% off) |
| `update_discount_code_basic` | Update a basic code discount |
| `create_discount_automatic_basic` | Create an auto-applied basic discount |
| `update_discount_automatic_basic` | Update an auto-applied basic discount |
| `create_discount_code_bxgy` | Create a BXGY (buy X get Y) code discount |
| `update_discount_code_bxgy` | Update a BXGY code discount |
| `create_discount_automatic_bxgy` | Create an auto-applied BXGY discount |
| `update_discount_automatic_bxgy` | Update an auto-applied BXGY discount |
| `create_discount_code_free_shipping` | Create a free shipping code discount |
| `update_discount_code_free_shipping` | Update a free shipping code discount |
| `create_discount_automatic_free_shipping` | Create an auto-applied free shipping discount |
| `update_discount_automatic_free_shipping` | Update an auto-applied free shipping discount |
| `activate_discount` | Activate (enable) a discount |
| `deactivate_discount` | Deactivate (disable) a discount |
## Required API Scopes
- `read_orders`
- `read_products`, `write_products`
- `read_content`, `write_content`
- `read_themes`, `write_themes`
- `read_online_store_navigation`, `write_online_store_navigation`
- `read_discounts`, `write_discounts`
