How to add Shopify Dev MCP to Windsurf

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

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Shopify Dev MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Shopify Dev MCP's tools become available to Cascade.

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 Windsurf

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

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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