MCP Directory

Shopify Dev MCP

Official

Shopify's official dev server: learn Shopify APIs, search docs, and validate GraphQL, Liquid and component code locally.

Unverified
stdio (local)
No auth
TypeScript
View repo 0 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
npx -y @shopify/dev-mcp@latest

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

  • Node.js 18 or higher
  • An MCP-capable client (Claude Code, Cursor, VS Code, Codex, etc.)
  • No Shopify account or API credentials needed

About Shopify Dev MCP

The workflow is deliberately sequenced: the agent calls learn_shopify_api first, which loads instructions for a chosen API surface (Admin GraphQL, Functions, Polaris, and so on) and issues a conversation ID that the other tools require. From there, search_docs_chunks retrieves relevant shopify.dev documentation, and the validate tools check generated code before it ever reaches your project.

Validation is the substantive part. The package ships gzipped schema dumps per API version — Admin API 2025-07 through 2026-07, Customer APIs, and Shopify Functions targets like cart_transform and cart_checkout_validation — so validate_graphql_codeblocks checks queries against the exact version you target, offline. Theme and UI-component validators (validate_theme, validate_theme_codeblocks, validate_component_codeblocks) do the same for Liquid and component code.

In Shopify's current tooling stack, shopify.dev recommends the Shopify AI Toolkit plugin (auto-updating skills bundle) for Claude Code, Codex, and Cursor, with the Dev MCP server as the plain-MCP alternative. Note this is developer tooling only — it never calls your store's Admin API; Shopify's separate Storefront MCP handles live shopper-facing data.

Trade-offs: no live store access by design, and with the GitHub repo now private you can't file issues or read source — you get npm releases (roughly weekly) and shopify.dev docs. Requires Node.js 18+.

Tools & capabilities (6)

learn_shopify_api

Load curated context for a Shopify API surface and get the conversation ID required by the other tools — always the first call

search_docs_chunks

Full-text search across shopify.dev developer documentation, scoped to the loaded API

validate_graphql_codeblocks

Validate GraphQL code blocks against the bundled schema for the selected API and version

validate_theme

Validate a Liquid theme against Shopify theme requirements

validate_theme_codeblocks

Validate individual Liquid/theme code blocks

validate_component_codeblocks

Validate UI-component code blocks against Shopify's component schemas

What this server can do

Shopify Dev MCP provides tools for these capabilities — tap one to see every MCP server that does the same:

Search documentation

When to use it

  • Generate Admin GraphQL queries that validate against the exact API version (e.g. 2026-07) before running them
  • Build Shopify Functions with the correct target schema instead of guessed input shapes
  • Search shopify.dev docs from inside your editor while building an app or theme
  • Lint agent-written Liquid and Polaris component code before committing

Quick setup

  1. 1Claude Code: run `claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest`, then restart
  2. 2Other clients: add the npx JSON config to Cursor / VS Code mcp.json / ~/.codex/config.toml
  3. 3Windows connection errors: use the documented fallback with command `cmd` and args ["/k", "npx", "-y", "@shopify/dev-mcp@latest"]
  4. 4Start a prompt that names your API surface (e.g. "using the Admin API…") so the agent calls learn_shopify_api first

Security notes

Runs locally and requires no auth or store credentials — it only works with Shopify's public developer docs and bundled API schemas, so no store data is at risk. The source repo is no longer public on GitHub; pin an npm version if you need to audit exactly what you run.

Shopify Dev MCP FAQ

Does shopify-dev-mcp need my store's API credentials?

No. It's documentation and schema tooling only — it runs locally without authentication and never talks to your store. For live store data you'd use Shopify's separate offerings like Storefront MCP or the Admin API directly.

Is Shopify Dev MCP free?

Yes. It's a free, ISC-licensed npm package, and the docs and schemas it queries are public. There's no Shopify plan requirement to use it.

Why can't I find the GitHub repository?

Shopify/dev-mcp is no longer public — distribution moved to npm releases with docs on shopify.dev. If you need reproducibility or auditability, pin a specific npm version instead of @latest.

#shopify#ecommerce#graphql#documentation#official

Alternatives to Shopify Dev MCP

Compare all alternatives →
Playwright MCP Server
Developer Tools
24k

Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).

Featured
Verified
stdio (local)
No auth
TypeScript
12 tools
Updated 26 days agoRepo
Context7 MCP Server
Developer Tools
28k

Up-to-date, version-specific library documentation injected into your coding agent.

Verified
stdio (local)
API key
TypeScript
2 tools
Updated 1 month agoRepo
Repomix MCP Server
Developer Tools
27k

Pack any local or remote repository into one AI-ready file your agent can grep and read incrementally.

Unverified
stdio (local)
No auth
TypeScript
6 tools
Updated 5 hours agoRepo

Compare Shopify Dev MCP with:

vs Playwright MCP Servervs Context7 MCP Servervs Repomix MCP Servervs codebase-memory-mcp