MCP Directory

How to add Shopify Dev MCP to Claude Desktop

Shopify's official dev server: learn Shopify APIs, search docs, and validate GraphQL, Liquid and component code locally. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 0★ · stdio · no auth · official

Claude Desktop config for Shopify Dev MCP

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

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Shopify Dev MCP config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Shopify Dev MCP's tools appear under the 🔌 tools menu.

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

What Shopify Dev MCP can do in Claude Desktop

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

Security

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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Shopify Dev MCP config there under the "mcpServers" key and restart the client.

Is Shopify Dev MCP safe to use with Claude Desktop?

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.

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.

View repo Full Shopify Dev MCP page