Skip to content

MCP server

Shopify Dev MCP server

Shopify's Dev MCP server helps developers build for Shopify: it searches Shopify docs and API schemas and validates GraphQL, components and themes.

At a glance

Maintained by
Shopify
Tools exposed
6 listed below
Reviewed
September 24, 2026

Why it matters

What it does and why it matters

Shopify's Dev MCP server is a tool for people who build on Shopify: app developers, theme developers and agencies. It lets a coding assistant learn a Shopify API, search the documentation, and validate GraphQL queries, UI components and theme code against Shopify's real schemas.

That matters because Shopify's APIs are large and change often. Validation catches code that would fail before it ever reaches a store.

It is important to be clear about what it does not do: it does not read or change store data such as orders, products or customers. It reads documentation and schemas and checks code, so the risk to a live store is low. For working with store data, an app built on the Admin API with the right permissions is the route.

We use tools like this when building custom Shopify features for clients, because they cut the time spent debugging API calls. See ecommerce websites.

Use cases

Best business use cases

App development

Write Admin API calls that match the current schema.

Theme work

Validate Liquid theme code before deploying.

Docs answers

Answer Shopify questions from current docs.

GraphQL checks

Validate queries against the real schema.

UI components

Check app UI components are used correctly.

Tools

Available tools

Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.

Read and write: Read only for store data. It reads docs and schemas and validates code; it does not change a store.

  • learn_shopify_api

    Loads an overview of a Shopify API and starts a conversation ID that later tools need.

  • search_docs_chunks

    Searches shopify.dev and returns matching documentation and code examples.

  • validate_graphql_codeblocks

    Checks GraphQL code against the Shopify API schema.

  • validate_component_codeblocks

    Checks UI extension component code.

  • validate_theme

    Validates Liquid theme files.

  • validate_theme_codeblocks

    Validates Liquid theme code snippets.

Workflows

Example workflows

Build a product sync feature

  1. 1

    A developer describes the feature.

  2. 2

    The assistant learns the relevant Shopify API.

  3. 3

    It writes the GraphQL query.

  4. 4

    It validates the query against the schema.

  5. 5

    The developer tests on a development store.

Fix a theme before launch

  1. 1

    Run theme validation.

  2. 2

    The assistant lists errors.

  3. 3

    It explains each one with the docs.

  4. 4

    It suggests fixes.

  5. 5

    The developer applies and re-validates.

Prompts

Example prompts

  • “Write a GraphQL query to fetch products with low inventory and validate it.”

  • “Validate this theme and explain any errors.”

  • “How do metafields work in the current Admin API?”

Setup

Installation and configuration

Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.

Claude Desktop: claude_desktop_config.json

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

Claude Code: terminal

claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest
  • Local server: npx -y @shopify/dev-mcp@latest.
  • Needs: None. Runs locally and does not require authentication..

Security

Security considerations

  • No store data

    It does not access store data, so risk to live stores is low.

  • Test on dev stores

    Test generated code on a development store.

  • Review code

    Review generated code before deploying.

  • Keep app keys separate

    Do not paste store API keys into prompts.

Related servers

Servers that pair well with it

WooCommerce

WooCommerce's official MCP support, in preview, exposes store abilities for products and orders through the WordPress MCP Adapter.

BigCommerce

BigCommerce's official Storefront MCP, in beta, lets AI shopping assistants browse the catalog, build carts and hand shoppers to checkout.

Stripe

Stripe's official MCP server lets AI search and read Stripe data, make changes with confirmation for sensitive actions, run analytics and search docs.

Keep exploring

FAQ

Questions people ask us

Have a question that is not here? Ask us directly.

Start a project

Want this connected to your own systems? We build AI workflows with MCP.

Send a short brief. We reply with questions, a suggested plan and an estimate you can compare with other offers.

Your privacy choices

We use necessary storage to run this site. With your permission we also use Google Analytics to see which pages help people, and load maps from Google. You can change this at any time. Read the cookie policy.