Shopify Dev MCP Server

Shopify Dev MCP is the official Model Context Protocol server published by Shopify for app, theme, and storefront developers. It exposes Shopify's developer surface area (documentation, GraphQL Admin / Storefront / Functions / Customer Account schemas, and Polaris Web Components) to AI coding agents so they can write correct Shopify code without hallucinating fields, types, or Liquid tags.

The server runs locally via npx, requires no API keys or OAuth, and is designed to be zero-config. Agents typically start by calling learn_shopify_api to orient themselves, then chain into doc search, schema introspection, and validation tools. Optional flags enable Liquid theme validation (LIQUID) and Polaris unified web component docs (POLARIS_UNIFIED), and instrumentation can be disabled with OPT_OUT_INSTRUMENTATION.

Because it is maintained by Shopify and pulls live data from shopify.dev, it is the most reliable way to keep an AI agent up to date with current Shopify APIs and theme primitives. It works with Claude Code, Claude Desktop, Cursor, VS Code, Codex CLI, and Gemini CLI.

Tools

Prerequisites

• Node.js 18+ (Node 20+ recommended for Polaris features)
• An MCP-compatible client (Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI, or Gemini CLI)
• No Shopify account, API key, or OAuth required

Install

The server is published to npm as @shopify/dev-mcp and is intended to be run via npx, no global install needed:

npx -y @shopify/dev-mcp@latest

Config JSON (Claude Desktop, Cursor, VS Code)

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

Windows alternative

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "@shopify/dev-mcp@latest"]
    }
  }
}

Claude Code CLI

claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

Optional environment variables

Enable extra tooling by adding an env block:

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"],
      "env": {
        "POLARIS_UNIFIED": "true",
        "LIQUID": "true",
        "LIQUID_VALIDATION_MODE": "full",
        "OPT_OUT_INSTRUMENTATION": "true"
      }
    }
  }
}

• POLARIS_UNIFIED: surfaces Polaris Web Components docs.
• LIQUID: enables the theme validation tools.
• LIQUID_VALIDATION_MODE: full (default, enables validate_theme) or partial (enables validate_theme_codeblocks).
• OPT_OUT_INSTRUMENTATION: disables the anonymous usage telemetry Shopify uses to improve the server.

• Generate Shopify Admin GraphQL queries or mutations and validate them against the live schema before running them, eliminating hallucinated fields.
• Build Shopify apps with up-to-date docs: have the agent search shopify.dev and fetch full pages for OAuth, webhooks, billing, or Functions.
• Develop Liquid themes with validate_theme to catch invalid filters, schema settings, or section/block usage during agent-driven edits.
• Build embedded admin UI with Polaris Web Components, with the agent fetching the right component, props, and slots from Polaris unified docs.
• Migrate code between API versions by introspecting the schema for a specific version and asking the agent to rewrite calls.

• "Write a GraphQL mutation to create a draft order with a custom line item, then validate it against the Admin API."
• "Search shopify.dev for how to register a webhook for orders/create in a Remix app and show me a working handler."
• "Introspect the Storefront API schema and list every field available on Product in the 2026-01 version."
• "Validate this Liquid section file and tell me which schema settings are invalid."
• "Show me the Polaris web component for a resource list and write a sample using its slots."

• Official, maintained by Shopify, and pulls live data from shopify.dev so it stays current with API versions.
• Zero auth required, runs locally via npx, trivial to install in any MCP client.
• Combines docs, schema introspection, and validation in one server, which catches hallucinated GraphQL fields and Liquid mistakes before code ships.
• Covers many Shopify surfaces: Admin, Storefront, Customer Account, Functions, Polaris, and Liquid themes.

• Read-only developer assistant: it cannot call your Shopify store, create products, or run admin operations. For that you need a separate Shopify Admin API MCP.
• Theme validation and Polaris docs are gated behind opt-in env flags, so they are easy to miss on first setup.
• Sends anonymous instrumentation by default; users who need to disable it must set OPT_OUT_INSTRUMENTATION explicitly.

• GeLi2001/shopify-mcp: community MCP that actually calls the Shopify Admin GraphQL API on a real store (products, orders, customers).
• amir-bengherbi/shopify-mcp-server: another community MCP for live Shopify Admin API access.
• ramakay/ShopifyMockMCP: community MCP for prototyping against mock.shop without a real store.