MCP server
Shopify Dev MCP Server
- Maintainer
- Official · Shopify
- Runs
- Local (stdio)
- Docs
- shopify.dev
- Connects to
- Shopify
- DevHunt
- Shopify on DevHunt
Install the Shopify Dev MCP Server
Pick your client. Each tab starts the same local command. Config shapes checked against each client's docs on 2026-10-25.
Run in a terminal. Everything after -- is the command that starts the server. docs
claude mcp add --transport stdio shopify-dev -- npx -y @shopify/dev-mcp@latest
Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs
{
"mcpServers": {
"shopify-dev": {
"command": "npx",
"args": [
"-y",
"@shopify/dev-mcp@latest"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"shopify-dev": {
"command": "npx",
"args": [
"-y",
"@shopify/dev-mcp@latest"
]
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"shopify-dev": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@shopify/dev-mcp@latest"
]
}
}
}Run codex mcp add shopify-dev -- npx -y @shopify/dev-mcp@latest, or add this to ~/.codex/config.toml. docs
[mcp_servers.shopify-dev] command = "npx" args = ["-y", "@shopify/dev-mcp@latest"]
Run in a terminal (-s user adds it for all projects; the default is this project). docs
gemini mcp add -s user shopify-dev npx -- -y @shopify/dev-mcp@latest
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add shopify-dev -- npx -y @shopify/dev-mcp@latest
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"shopify-dev": {
"command": "npx",
"args": [
"-y",
"@shopify/dev-mcp@latest"
]
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"shopify-dev": {
"command": "npx",
"args": [
"-y",
"@shopify/dev-mcp@latest"
]
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"shopify-dev": {
"type": "local",
"command": [
"npx",
"-y",
"@shopify/dev-mcp@latest"
],
"enabled": true
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"shopify-dev": {
"command": "npx",
"args": [
"-y",
"@shopify/dev-mcp@latest"
]
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"shopify-dev": {
"command": "npx",
"args": [
"-y",
"@shopify/dev-mcp@latest"
]
}
}
}Security notes
- The local server runs with your user's permissions (npx downloads it from npm on first run). The package is pinned to @latest, so each start can pull a new version; pin a version if you want to review updates.
- Start with test-mode or restricted keys: tools can create charges, refunds or customers.
Alternatives
- Shopify Storefront (UCP)official
Every Shopify store's MCP endpoint for catalog search, carts and checkout via UCP.
- Polarofficial · ★ 10k
Products, customers, orders and subscriptions in Polar (hosted server).
- Stripeofficial · ★ 2k
Customers, products, payment links, invoices, refunds and Stripe docs search.
- QuickBooks Onlineofficial · ★ 434
Read and create QuickBooks Online customers, invoices, bills and accounts.
- Xeroofficial · ★ 385
Xero contacts, invoices, payments, payroll and accounting reports.
- Razorpayofficial · ★ 231
Payments, orders, refunds, payment links and settlements in Razorpay.
- PayPalofficial · ★ 197
Invoices, orders, subscriptions, disputes and reports in PayPal.
- Squareofficial · ★ 109
Payments, orders, catalog, customers and inventory through the Square API.
Comparing servers for one product? Shopify MCP servers
FAQ
What does the Shopify Dev MCP Server do?+
Search Shopify docs and explore and validate Admin GraphQL and Liquid code.
Is the Shopify Dev MCP server official?+
Official: built and maintained by Shopify.
How do I add Shopify Dev to Claude Code?+
Run: claude mcp add shopify-dev -- npx -y @shopify/dev-mcp@latest. Add --scope project to share it with your team through .mcp.json.
How do I use the Shopify Dev MCP server in Cursor or VS Code?+
Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("stdio").
Does Shopify Dev work in ChatGPT and claude.ai?+
No: it runs locally over stdio, and ChatGPT and claude.ai only connect to remote servers. Use it in Claude Desktop, Claude Code, Cursor, VS Code or another client that can start a local process.
What are the alternatives to the Shopify Dev MCP server?+
Other payments & e-commerce MCP servers: Shopify Storefront (UCP), Polar, Stripe, QuickBooks Online and Xero.