shopify-store-builder-mcp

MCP server for building Shopify stores with AI. Gives Claude Code, Cursor, and other MCP clients tools to edit themes, pages, and navigation on one Shopify store via the Admin GraphQL API.

Credentials stay on your machine. The server runs locally and talks directly to Shopify.

Demo

https://github.com/user-attachments/assets/afd71d46-e8d7-4c06-96dc-094cae3fe5a2

Quick start

https://github.com/user-attachments/assets/175e5051-b6ec-4201-a33e-d27c68356171

npx -y shopify-store-builder-mcp init

The wizard asks for your store credentials, verifies the connection, and registers the server in the client you pick:

• Claude Code
• Codex CLI
• Gemini CLI
• Claude Desktop
• Cursor
• Windsurf
• VS Code (Copilot)

Pick "Other" to print a config entry for any other MCP client.

Getting Shopify credentials

You need a store on a plan with Admin API access and one of:

Option A: Dev Dashboard app (recommended, tokens auto-refresh)

1. Go to dev.shopify.com/dashboard and create an app for your store.
2. Grant it the scopes: read_themes, write_themes, read_content, write_content, read_online_store_navigation, write_online_store_navigation.
3. Copy the Client ID and Client Secret from the app's settings.

Option B: permanent admin access token

Use an existing shpat_… token from a custom app in your store admin (Settings → Apps and sales channels → Develop apps).

Manual configuration

If you skip the wizard, add this to your MCP client's config:

{
  "shopify-builder": {
    "command": "npx",
    "args": ["-y", "shopify-store-builder-mcp"],
    "env": {
      "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
      "SHOPIFY_CLIENT_ID": "…",
      "SHOPIFY_CLIENT_SECRET": "…"
    }
  }
}

Or with a permanent token, replace the client credentials with "SHOPIFY_ADMIN_ACCESS_TOKEN": "shpat_…".

Tools

Tool	What it does
shop_get_info	Read store name, domain, plan, currency
theme_list	List installed themes
theme_read_file	Read a theme file (Liquid, JSON, CSS, JS)
theme_update_file	Create or update a theme file
page_list	List store pages
page_create	Create a page
page_update	Update a page's title, body, or visibility
menu_list	List navigation menus
menu_update	Update a navigation menu

Development

npm install
npm run dev     # run from source
npm run build   # compile to dist/
npm test

License

ISC