AI Tool Atlas
MCP server Official

Shopify Dev MCP

Shopify's local Dev MCP server: search Shopify docs and API schemas and validate GraphQL, Liquid and extension code.

Author
Shopify
Works with
Any MCP client, Claude Code, Cursor, OpenAI Codex
License
ISC
Last release
Sep 25, 2026
Documented
Oct 2, 2026
Repository ↗ Official docs ↗ Registry ↗

What Shopify Dev MCP is

@shopify/dev-mcp is Shopify's MCP server for building on the Shopify platform. It lets agents search documentation and API schemas, validate GraphQL operations, Liquid and theme files and UI-extension code, and resolve supported API versions. It runs locally over stdio without authentication.

What it does

How Shopify Dev MCP plugs in: which agents run it and what it addsRUNS INYour agentClaude CodeOpenAI CodexCursorAny MCP client4 hosts documentedMCP SERVER · OFFICIALShopify Dev MCPConnect the agent to tools, data…5 install steps1 permission notelicense: ISCWHAT IT ADDSWhat it doesSearches Shopify documentation an…Validates GraphQL operations agai…Validates Liquid templates and th…Validates UI-extension codeagent → extension → new capability · from the official repository or docs
Where Shopify Dev MCP runs and what it adds, from its documentation
  • Searches Shopify documentation and API schemas
  • Validates GraphQL operations against Shopify schemas
  • Validates Liquid templates and theme files
  • Validates UI-extension code
  • Resolves supported API versions

When to use it

Good fit

  • Building Shopify apps, themes or extensions with an AI agent
  • Catching GraphQL or Liquid errors before deploying
  • Migrating checkout or customer account extensions to newer API versions

Not for

  • Clients that support the plugin: Shopify recommends the full AI Toolkit plugin instead

How to install Shopify Dev MCP

You need: Node.js 18 or later

  1. Ensure Node.js 18 or later is installed
  2. Claude Code: claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest
  3. Codex CLI: add [mcp_servers.shopify-dev-mcp] with command = "npx" and args = ["-y", "@shopify/dev-mcp@latest"] to ~/.codex/config.toml
  4. Cursor/VS Code: add the npx config to your MCP settings
  5. Restart the client
Configuration example (from the official docs)
{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

Permissions and security

What it can access

  • Runs locally over stdio; no authentication required

Security notes from the maintainers

  • Release builds send usage events to https://shopify.dev/mcp/usage, which can include tool inputs and results
  • Opt out with an empty ~/.config/shopify-ai-toolkit/opt-out file, OPT_OUT_INSTRUMENTATION=true or DO_NOT_TRACK=1

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Limitations

  • LIQUID_VALIDATION_MODE=partial removes validate_theme and validates code blocks only

Tools it extends

Frequently asked questions

How do I install the Shopify Dev MCP server?

Run npx -y @shopify/dev-mcp@latest or add it to your client's MCP config; Node.js 18+ is required. source

Does the Shopify Dev MCP server collect telemetry?

Yes in release builds; it sends usage events to shopify.dev, and you can opt out with DO_NOT_TRACK=1 or an opt-out file. source

Does Shopify Dev MCP need authentication?

No, it runs locally over stdio without authentication. source

Should I use the Shopify AI Toolkit plugin instead of Shopify Dev MCP?

Shopify recommends the plugin when your client supports it; the MCP server is for MCP-only setups. source

Related guides

Sources and gaps

Not stated by the maintainers: github.com/Shopify/dev-mcp returned 404, so repo_url points to the Shopify AI Toolkit repo named in the docs; License ISC taken from npm metadata.

More extensions to look at