The Complete Shopify MCP

One MCP server for nearly the entire Shopify Admin API.

Products, orders, customers, discounts, pages, blogs, themes, navigation, metafields, metaobjects, files, redirects, gift cards, inventory, collections — 71 tools, 16 domains, one install.

npx complete-shopify-mcp --domain your-store.myshopify.com --accessToken shpat_xxxxx

Why

Every Shopify MCP server only covers a slice. One does products. Another does discounts. Another does themes. You end up juggling 3-5 repos to fully control a store through AI.

This project fixes that. One package. Full coverage.

Install

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "complete-shopify-mcp",
        "--domain", "your-store.myshopify.com",
        "--accessToken", "shpat_xxxxxxxxxxxxx"
      ]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["complete-shopify-mcp"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxx"
      }
    }
  }
}

Environment Variables

export SHOPIFY_STORE_DOMAIN=your-store.myshopify.com
export SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxx
npx complete-shopify-mcp

Coverage

| Domain | Tools | Operations | |--------|-------|------------| | Products | 6 | list, get, create, update, delete, search | | Orders | 5 | list, get, cancel, update, create draft | | Customers | 4 | list, get, create, update | | Collections | 5 | list, get, create, update, add products | | Inventory | 4 | list locations, get levels, set, adjust | | Discounts | 6 | list, create code, create automatic, activate, deactivate, delete | | Pages | 5 | list, get, create, update, delete | | Blogs & Articles | 7 | list blogs, list/get/create/update/delete articles, create blog | | Themes | 5 | list, get file, update file, delete file, publish | | Navigation | 5 | list, get, create, update, delete menus | | Metafields | 3 | get, set, delete (on any resource) | | Metaobjects | 6 | list, get, create, update, delete, list definitions | | Redirects | 4 | list, create, update, delete | | Files | 3 | list, upload from URL, delete | | Gift Cards | 3 | list, create, disable | | Shop | 1 | get store info |

Comparison

| | complete-shopify-mcp | shopify-mcp | cob-shopify-mcp | shopify-admin-mcp | |---|:---:|:---:|:---:|:---:| | Products | ✅ | ✅ | ✅ | partial | | Orders | ✅ | ✅ | ✅ | ❌ | | Customers | ✅ | ✅ | ✅ | ❌ | | Collections | ✅ | ❌ | ✅ | ✅ | | Inventory | ✅ | partial | ✅ | ❌ | | Discounts | ✅ | ❌ | ❌ | ✅ | | Pages | ✅ | ❌ | ❌ | ❌ | | Blogs/Articles | ✅ | ❌ | ❌ | ✅ | | Themes | ✅ | ❌ | ❌ | ✅ | | Navigation | ✅ | ❌ | ❌ | ✅ | | Metafields | ✅ | ✅ | ❌ | ❌ | | Metaobjects | ✅ | ❌ | ❌ | ❌ | | Redirects | ✅ | ❌ | ❌ | ❌ | | Files/Media | ✅ | ❌ | ❌ | ❌ | | Gift Cards | ✅ | ❌ | ❌ | ❌ | | Rate Limiting | ✅ | ❌ | ✅ | ❌ | | Retries | ✅ | ❌ | ✅ | ❌ | | Caching | ✅ | ❌ | ✅ | ❌ |

Example Prompts

"Create a product called Summer Vibes Tee, $29.99, draft status"
"Create a 20% off discount code SUMMER20 that expires July 1st"
"Upload this image as a product photo: https://..."
"Update the About Us page with new content"
"Publish a blog post about our new summer collection"
"Create a redirect from /old-page to /new-page"
"Add a new link to the main navigation menu"
"Set inventory to 50 units for SKU-123 at our warehouse"
"Create a $50 gift card for customer support"
"List all metaobject definitions in the store"
"Deploy an update to the header.liquid theme file"

Getting Your Access Token

1. Shopify Admin → Settings → Apps and sales channels
2. Develop apps → Create an app
3. Configure Admin API scopes:

read_products, write_products, read_orders, write_orders,
read_customers, write_customers, read_inventory, write_inventory,
read_locations, read_content, write_content, read_themes, write_themes,
read_online_store_navigation, write_online_store_navigation,
read_discounts, write_discounts, read_files, write_files,
read_metaobject_definitions, write_metaobject_definitions,
read_metaobjects, write_metaobjects, read_gift_cards, write_gift_cards

4. Install the app → Copy the Admin API access token

Architecture

MCP Server (stdio)
  → Tool Registry (71 tools)
    → Shopify GraphQL Client
      • Cost-based rate limiting
      • Retries with exponential backoff
      • Response caching (30s TTL)
    → Shopify Admin GraphQL API (2025-01)

TypeScript. Three dependencies (@modelcontextprotocol/sdk, zod, dotenv). Single 86KB bundle.

Configuration

| Variable | Flag | Description | |----------|------|-------------| | SHOPIFY_STORE_DOMAIN | --domain | Store domain | | SHOPIFY_ACCESS_TOKEN | --accessToken | Admin API token | | SHOPIFY_API_VERSION | --apiVersion | API version (default: 2025-01) |

License

MIT