Shopify Dev MCP MCP server
Shopify's official dev MCP server grounds agents in up-to-date Shopify API docs, schemas, and code validation.
Shopify Dev MCP is Shopify's official server for building on the Shopify platform with an AI assistant. Rather than touching a live store, it connects the agent to Shopify's developer resources so generated code is correct against the current APIs. The agent starts by calling learn_shopify_api to load up-to-date context for a chosen surface, such as the Admin GraphQL API, Functions, Storefront, Liquid themes, Hydrogen, or Polaris components, and receives a conversation ID that threads through later calls. It can then search shopify.dev documentation for relevant guides and code examples, and validate generated GraphQL operations, theme files, and component code blocks against the real schema so the model does not ship hallucinated fields.
The server runs locally over stdio and requires no authentication or store credentials, which makes it safe to add to any project. The canonical install is npx -y @shopify/dev-mcp@latest. Optional environment variables enable extra surfaces such as Storefront web components and tune Liquid theme validation, and you can opt out of usage instrumentation. It is the verifiable, officially published path for grounding Shopify app and theme development in agents.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": [
"-y",
"@shopify/dev-mcp@latest"
],
"env": {
"OPT_OUT_INSTRUMENTATION": "<OPT_OUT_INSTRUMENTATION>",
"STOREFRONT_WEB_COMPONENTS": "<STOREFRONT_WEB_COMPONENTS>",
"LIQUID_VALIDATION_MODE": "<LIQUID_VALIDATION_MODE>"
}
}
}
}claude mcp add shopify -- npx -y @shopify/dev-mcp@latestAvailable tools
| Tool | Description |
|---|---|
| learn_shopify_api | Mandatory first step that loads up-to-date context for a chosen Shopify API or surface and returns a conversationId to thread through later calls. |
| search_docs_chunks | Searches shopify.dev documentation and returns relevant docs and code examples for the user's prompt. |
| validate_graphql_codeblocks | Validates GraphQL code blocks against the Shopify GraphQL schema to catch hallucinated fields and operations. |
| validate_component_codeblocks | Validates code blocks that use components from Shopify packages such as Polaris. |
| validate_theme | Validates files created, updated, or deleted inside a Shopify theme directory. |
| validate_theme_codeblocks | Validates Liquid and theme code blocks generated or updated by the assistant. |
Required configuration
- OPT_OUT_INSTRUMENTATIONOptional
Set to true to disable anonymous usage instrumentation. Optional.
- STOREFRONT_WEB_COMPONENTSOptional
Set to true to enable Storefront web components support. Optional.
- LIQUID_VALIDATION_MODEOptional
Controls how Liquid theme code validation behaves. Optional.
What you can do with it
Generate correct Shopify API code
Before writing an Admin GraphQL query, the agent loads the current schema with learn_shopify_api and validates its output so it does not invent fields that no longer exist.
Build and check a theme or app
While editing a Liquid theme or Polaris-based app, the agent searches shopify.dev for the right pattern and validates the files it touches against Shopify's rules.
FAQ
- Is it free?
- Yes. The Shopify Dev MCP server is free and open: it runs locally over npx with no Shopify account, store credentials, or paid plan required.
- Does it support remote/OAuth?
- No. It runs locally over stdio and needs no authentication because it talks to Shopify's public developer docs and schemas, not to a live store. Install it with npx -y @shopify/dev-mcp@latest.
- Does it modify my store?
- No. This server is for development: it teaches APIs, searches docs, and validates code. It does not read or write store data such as products or orders.