Shopify Dev MCP for Claude

Content

Shopify Dev MCP is the direct MCP-server install path for the official Shopify AI Toolkit. It runs locally with npx -y @shopify/dev-mcp@latest and gives Claude, Codex, Cursor, Gemini CLI, VS Code, and other MCP clients access to Shopify developer documentation, API schema guidance, GraphQL validation, Liquid and theme checks, UI extension validation, Shopify Functions guidance, Polaris surfaces, and Shopify CLI workflow instructions.

Use it when the assistant needs current Shopify platform context while building apps, themes, storefronts, checkout extensions, customer account extensions, POS extensions, Functions, Admin GraphQL workflows, Storefront API flows, or Partner API workflows. Keep the boundary clear: the Dev MCP server is a developer resource server, while real store operations require separately authenticated Shopify CLI commands and human review.

Features

• Official Shopify AI Toolkit source from Shopify/Shopify-AI-Toolkit.
• Direct local stdio MCP setup through npx -y @shopify/dev-mcp@latest.
• Documented setup examples for Claude Code, Codex, Cursor, Gemini CLI, and VS Code.
• No authentication required for the documented Dev MCP developer-resource server.
• learn_shopify_api guidance for selecting relevant Shopify APIs and versions.
• search_docs_chunks for finding current Shopify developer documentation and API references.
• validate_graphql_codeblocks for validating GraphQL operations against Shopify Admin, Storefront, Customer Account, Partner, Payments Apps, and Functions schemas.
• validate_component_codeblocks for validating UI extension and Polaris component code against supported surfaces and API versions.
• validate_theme and validate_theme_codeblocks for Liquid and theme validation.
• Bundled schema data for Admin, Storefront, Partner, Customer, Payments Apps, and multiple Shopify Functions APIs across stable, release-candidate, and unstable API versions.
• Shopify CLI guidance for app scaffolding, extension generation, app config validation, development, deployment, store authentication, and store-scoped GraphQL execution.
• Optional alternate install paths through the auto-updating Shopify AI Toolkit plugin or individual Shopify agent skills.

Use Cases

• Ask Claude to validate an Admin GraphQL mutation before adding it to a Shopify app.
• Search Shopify docs for the right API version, extension target, Polaris component, Liquid object, or Functions input shape.
• Validate Liquid snippets, theme schema blocks, JSON templates, and translation files before changing a theme.
• Generate checkout, customer account, POS, Admin, or app-home UI extension code and validate the component surface before shipping.
• Build or debug Shopify Functions with schema-backed GraphQL input validation.
• Convert a store task into a scoped Shopify CLI workflow using shopify store auth and shopify store execute, then review the command before running it.
• Keep a Shopify app, theme, or extension conversation grounded in Shopify's current docs instead of relying on stale model memory.

Installation

Claude Code

Add the MCP server through Claude Code's stdio MCP configuration:

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

Restart Claude Code after adding the server.

Generic MCP JSON

Use this shape for MCP clients that accept mcpServers JSON:

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

Codex CLI

Codex uses TOML-style MCP configuration:

[mcp_servers.shopify-dev-mcp]
command = "npx"
args = ["-y", "@shopify/dev-mcp@latest"]

Restart the client after editing MCP configuration.

Configuration

Disable default instrumentation

Set OPT_OUT_INSTRUMENTATION=true when using AI Toolkit search or validation surfaces with private code, store-specific context, or sensitive file paths:

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

Store-scoped CLI workflow guardrail

For any task that targets a real Shopify store, require the assistant to state the store domain, scopes, operation type, and whether mutation execution is needed before running shell commands:

Validate the GraphQL operation first. If it is a mutation, do not run
`shopify store execute` until I approve the exact store domain, scopes, query,
variables, and `--allow-mutations` flag.

Examples

Validate a Shopify Admin GraphQL operation:

Use Shopify Dev MCP to validate this Admin GraphQL mutation against the current
stable API version. If validation fails, fix the operation and validate again.
Do not run it against a store.

Work on Liquid theme code:

Search Shopify docs for the relevant Liquid object and validate this section
schema and Liquid code. Point out errors before suggesting theme changes.

Prepare, but do not run, a store-scoped command:

Create a Shopify CLI workflow for reading inventory for SKU EXAMPLE-SKU from
staging-shop.myshopify.com. Validate the GraphQL query and show the exact
`shopify store auth` and `shopify store execute` commands, but do not run them.

Source Notes

• Official docs: Shopify AI Toolkit.
• Official repository: Shopify/Shopify-AI-Toolkit.
• npm package: @shopify/dev-mcp, binary shopify-dev-mcp, latest package checked as 1.14.0 on 2026-06-04.
• Shopify's docs state that the Dev MCP server runs locally and does not require authentication.
• The toolkit repository is MIT licensed; the npm package metadata for @shopify/dev-mcp currently reports ISC.
• The older https://shopify.dev/apps/build/devmcp path redirects to the current AI Toolkit documentation page.

Duplicate Check

• Checked current upstream content for Shopify titles, slugs, source URLs, shopify-dev-mcp, @shopify/dev-mcp, Shopify AI Toolkit, Shopify-AI-Toolkit, and the current and legacy docs URLs.
• Checked live open issues and pull requests for Shopify MCP and shopify-dev-mcp.
• No dedicated Shopify Dev MCP entry, source URL duplicate, target file duplicate, semantic duplicate, or open duplicate PR was found before drafting.

Disclosure

This is an independent community directory entry submitted by oktofeesh1. Shopify is a commercial ecommerce platform, but this listing is not sponsored, paid, affiliate-backed, or submitted by Shopify. Use Shopify's current docs, API terms, privacy policy, and Partner requirements before connecting an assistant to store-specific workflows.