How to add Shopify Dev MCP to Cursor

Shopify's official dev server: learn Shopify APIs, search docs, and validate GraphQL, Liquid and component code locally. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Shopify Dev MCP config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Shopify Dev MCP's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Shopify Dev MCP config there under the "mcpServers" key and restart the client.

Is Shopify Dev MCP safe to use with Cursor?

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